<html>
<head>
	<style>
		body
		{
			font-size: 14px;
		}
		pre
		{
			font-size: 11px;
		}
		h1
		{
			font-size: 24px;
			text-decoration: underline;
		}
		h2
		{
			font-size: 16px;
			margin: 0px;
		}
		*
		{
			margin: 0px;
		}
		li
		{
			margin-left: 0px;
		}
	</style>
	<script src="https://ajax.googleapis.com/ajax/libs/jquery/1.7.2/jquery.min.js"></script>
	<script>
		$(document).ready(function() {
		  $("h2 ~ ul").hide();
		  $("#sample ~ h2").hide();
		});
	</script>
</head>
<body>
<h1>album.addTags</h1>
    <div class="wsdescription">
        Tag an album using a list of user supplied tags.
    </div>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">artist</span> (Required) : The artist name<br />
                <span class="param">album</span> (Required) : The album name<br />
                <span class="param">tags</span> (Required) : A comma delimited list of user supplied tags to apply to this album. Accepts a maximum of 10 tags.<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                  <span class="param">api_sig</span> (Required) : A Last.fm method signature. See <a href="/api/authentication">authentication</a> for more information.<br />
                     <span class="param">sk</span> (Required) : A session key generated by authenticating a user via the authentication protocol.
                              <h2>Auth</h2>
                                     
                           This service requires authentication. Please see our <a href="/api/authentication">authentication</a> how-to.<br/>
                                        This is a <b>write</b> service and must be accessed with an HTTP POST request. All parameters should be sent in the POST body, including the 'method' parameter. See <a href="/api/rest">rest requests</a> for more information.
            l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;lfm status=&quot;ok&quot;&gt;
&lt;/lfm&gt;</pre>
                                    </div>
                                
                                    <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>album.getBuylinks</h1>
    <div class="wsdescription">
        Get a list of Buy Links for a particular Album.  It is required that you
supply either the artist and track params or the mbid param.
    </div>
        <p class="sampleurl">
    e.g. <a href="http://ws.audioscrobbler.com/2.0/?method=album.getbuylinks&artist=radiohead&album=in%20rainbows&country=united%20kingdom&api_key=b25b959554ed76058ac220b7b2e0a026">http://ws.audioscrobbler.com/2.0/?method=album.getbuylinks&artist=radiohead&album=in%20rainbows...</a> 
    </p>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">artist</span> (Required (unless mbid)] : The artist name<br />
                <span class="param">album</span> (Required (unless mbid)] : The album<br />
                <span class="param">mbid</span> (Optional) : The musicbrainz id for the album<br />
                <span class="param">autocorrect[0|1]</span> (Optional) : Transform misspelled artist names into correct artist names, returning the correct version instead.  The corrected artist name will be returned in the response.<br />
                <span class="param">country</span> (Optional) : A country name, as defined by the ISO 3166-1 country names standard.<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                     <h2>Auth</h2>
                                     
                           This service does <b>not</b> require authentication.
                        l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;?xml version=&quot;1.0&quot; encoding=&quot;utf-8&quot;?&gt;
    &lt;lfm status=&quot;ok&quot;&gt;
        &lt;affiliations&gt;
            &lt;physicals&gt;
                &lt;affiliation&gt;
                    &lt;supplierName&gt;Amazon&lt;/supplierName&gt;
                    &lt;buyLink&gt;http://www.last.fm/affiliate/byid/8/3418994/1/ws.album.buylinks.b25b959554ed76058ac220b7b2e0a026&lt;/buyLink&gt;
                    &lt;supplierIcon&gt;http://cdn.last.fm/favicons/amazon.gif&lt;/supplierIcon&gt;
                    &lt;isSearch&gt;1&lt;/isSearch&gt;
                &lt;/affiliation&gt;
                ...
                &lt;/physicals&gt;
            &lt;downloads&gt;
                &lt;affiliation&gt;
                    &lt;supplierName&gt;7digital&lt;/supplierName&gt;
                    &lt;buyLink&gt;http://www.last.fm/affiliate/byid/8/3418994/13/ws.album.buylinks.b25b959554ed76058ac220b7b2e0a026&lt;/buyLink&gt;
                    &lt;supplierIcon&gt;http://cdn.last.fm/favicons/7digital.gif&lt;/supplierIcon&gt;
                    &lt;isSearch&gt;1&lt;/isSearch&gt;
                &lt;/affiliation&gt;
                ...
            &lt;/downloads&gt;
    &lt;/affiliations&gt;
&lt;/lfm&gt;</pre>
                                    </div>
                                
                                    <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>album.getInfo</h1>
    <div class="wsdescription">
        Get the metadata and tracklist for an album on Last.fm using the album name
or a musicbrainz id.
    </div>
        <p class="sampleurl">
    e.g. <a href="http://ws.audioscrobbler.com/2.0/?method=album.getinfo&api_key=b25b959554ed76058ac220b7b2e0a026&artist=Cher&album=Believe">http://ws.audioscrobbler.com/2.0/?method=album.getinfo&api_key=b25b959554ed76058ac220b7b2e0a026...</a> 
    </p>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">artist</span> (Required (unless mbid)] : The artist name<br />
                <span class="param">album</span> (Required (unless mbid)] : The album name<br />
                <span class="param">mbid</span> (Optional) : The musicbrainz id for the album<br />
                <span class="param">autocorrect[0|1]</span> (Optional) : Transform misspelled artist names into correct artist names, returning the correct version instead.  The corrected artist name will be returned in the response.<br />
                <span class="param">username</span> (Optional) : The username for the context of the request. If supplied, the user's playcount for this album is included in the response.<br />
                <span class="param">lang</span> (Optional) : The language to return the biography in, expressed as an ISO 639 alpha-2 code.<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                     <h2>Auth</h2>
                                     
                           This service does <b>not</b> require authentication.
                        l
            <h2>Sample Response</h2>
                                                                                                                                                                                                                                            <div id="sample">
                    <pre>&lt;album&gt;
  &lt;name&gt;Believe&lt;/name&gt;
  &lt;artist&gt;Cher&lt;/artist&gt;
  &lt;id&gt;2026126&lt;/id&gt;
  &lt;mbid&gt;61bf0388-b8a9-48f4-81d1-7eb02706dfb0&lt;/mbid&gt;
  &lt;url&gt;http://www.last.fm/music/Cher/Believe&lt;/url&gt;
  &lt;releasedate&gt;6 Apr 1999, 00:00&lt;/releasedate&gt;
  &lt;image size=&quot;small&quot;&gt;...&lt;/image&gt;
  &lt;image size=&quot;medium&quot;&gt;...&lt;/image&gt;
  &lt;image size=&quot;large&quot;&gt;...&lt;/image&gt;
  &lt;listeners&gt;47602&lt;/listeners&gt;
  &lt;playcount&gt;212991&lt;/playcount&gt;
  &lt;toptags&gt;
    &lt;tag&gt;
      &lt;name&gt;pop&lt;/name&gt;
      &lt;url&gt;http://www.last.fm/tag/pop&lt;/url&gt;
    &lt;/tag&gt;
    ...
  &lt;/toptags&gt;
  &lt;tracks&gt;
    &lt;track rank=&quot;1&quot;&gt;
      &lt;name&gt;Believe&lt;/name&gt;
      &lt;<span class="tagDescription" title="In seconds">duration</span>&gt;239&lt;/duration&gt;
      &lt;mbid/&gt;
      &lt;url&gt;http://www.last.fm/music/Cher/_/Believe&lt;/url&gt;
      &lt;streamable fulltrack=&quot;0&quot;&gt;1&lt;/streamable&gt;
      &lt;artist&gt;
        &lt;name&gt;Cher&lt;/name&gt;
        &lt;mbid&gt;bfcc6d75-a6a5-4bc6-8282-47aec8531818&lt;/mbid&gt;
        &lt;url&gt;http://www.last.fm/music/Cher&lt;/url&gt;
      &lt;/artist&gt;
    &lt;/track&gt;
    ...
  &lt;/tracks&gt;
&lt;/album&gt;</pre>
                                        Hover over the underlined tags and attributes to get detailed information.
                                    </div>
                                
                                    <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>album.getShouts</h1>
    <div class="wsdescription">
        Get shouts for this album. Also available as an rss feed.
    </div>
        <p class="sampleurl">
    e.g. <a href="http://ws.audioscrobbler.com/2.0/?method=album.getshouts&artist=cher&album=believe&api_key=b25b959554ed76058ac220b7b2e0a026">http://ws.audioscrobbler.com/2.0/?method=album.getshouts&artist=cher&album=believe&api_key=b25b...</a> 
    </p>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">artist</span> (Required (unless mbid)] : The artist name<br />
                <span class="param">mbid</span> (Optional) : The musicbrainz id for the artist<br />
                <span class="param">limit</span> (Optional) : The number of results to fetch per page. Defaults to 50.<br />
                <span class="param">autocorrect[0|1]</span> (Optional) : Transform misspelled artist names into correct artist names, returning the correct version instead.  The corrected artist name will be returned in the response.<br />
                <span class="param">page</span> (Optional) : The page number to fetch.  Defaults to first page.<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                     <h2>Auth</h2>
                                     
                           This service does <b>not</b> require authentication.
                        l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;shouts artist=&quot;Cher&quot; album=&quot;Believe&quot; total=&quot;24&quot; page=&quot;1&quot; perPage=&quot;50&quot; totalPages=&quot;1&quot;&gt;
  &lt;shout&gt;
    &lt;body&gt;Just cannot get enough&lt;/body&gt;
    &lt;author&gt;Daniel5591&lt;/author&gt;
    &lt;date&gt;Thu, 19 Aug 2010 10:19:08&lt;/date&gt;
  &lt;/shout&gt;
  ...
&lt;/shout&gt;</pre>
                                    </div>
                                
                    <h2>Other Formats</h2>
                            Also available as a feed in <b>rss</b> format                <p>
                                    e.g. <a href="http://ws.audioscrobbler.com/2.0/album/shouts.rss">http://ws.audioscrobbler.com/2.0/album/shouts.rss</a><br />
                                </p>
                                                <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>album.getTags</h1>
    <div class="wsdescription">
        Get the tags applied by an individual user to an album on Last.fm. To
retrieve the list of top tags applied to an album by all users use
album.getTopTags.
    </div>
        <p class="sampleurl">
    e.g. <a href="http://ws.audioscrobbler.com/2.0/?method=album.gettags&artist=cher&album=believe&api_key=b25b959554ed76058ac220b7b2e0a026">http://ws.audioscrobbler.com/2.0/?method=album.gettags&artist=cher&album=believe&api_key=b25b95...</a> 
    </p>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">artist</span> (Required (unless mbid)] : The artist name<br />
                <span class="param">album</span> (Required (unless mbid)] : The album name<br />
                <span class="param">mbid</span> (Optional) : The musicbrainz id for the album<br />
                <span class="param">autocorrect[0|1]</span> (Optional) : Transform misspelled artist names into correct artist names, returning the correct version instead.  The corrected artist name will be returned in the response.<br />
                <span class="param">user</span> (Optional) : If called in non-authenticated mode you must specify the user to look up<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                     <h2>Auth</h2>
                                     
                           This service does <b>not</b> require authentication.
                        l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;tags artist=&quot;Sally Shapiro&quot; album=&quot;Disco Romance&quot;&gt;
  &lt;tag&gt;
    &lt;name&gt;swedish&lt;/name&gt;
    &lt;url&gt;http://www.last.fm/tag/swedish&lt;/url&gt;
  &lt;/tag&gt;
  ...
&lt;/tags&gt;</pre>
                                    </div>
                                
                                    <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>album.getTopTags</h1>
    <div class="wsdescription">
        Get the top tags for an album on Last.fm, ordered by popularity.
    </div>
        <p class="sampleurl">
    e.g. <a href="http://ws.audioscrobbler.com/2.0/?method=album.gettoptags&artist=radiohead&album=the%20bends&api_key=b25b959554ed76058ac220b7b2e0a026">http://ws.audioscrobbler.com/2.0/?method=album.gettoptags&artist=radiohead&album=the%20bends&ap...</a> 
    </p>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">artist</span> (Required (unless mbid)] : The artist name<br />
                <span class="param">album</span> (Required (unless mbid)] : The album name<br />
                <span class="param">autocorrect[0|1]</span> (Optional) : Transform misspelled artist names into correct artist names, returning the correct version instead.  The corrected artist name will be returned in the response.<br />
                <span class="param">mbid</span> (Optional) : The musicbrainz id for the album<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                     <h2>Auth</h2>
                                     
                           This service does <b>not</b> require authentication.
                        l
            <h2>Sample Response</h2>
                                                                                                                                                                                                                                            <div id="sample">
                    <pre>&lt;?xml version=&quot;1.0&quot; encoding=&quot;utf-8&quot;?&gt;
&lt;lfm status=&quot;ok&quot;&gt;
    &lt;toptags artist=&quot;Radiohead&quot; album=&quot;The Bends&quot;&gt;
        &lt;tag&gt;
            &lt;name&gt;albums I own&lt;/name&gt;
            &lt;<span class="tagDescription" title="A weighted count of how often the tag was applied, with a maximum of 100">count</span>&gt;100&lt;/count&gt;
            &lt;url&gt;http://www.last.fm/tag/albums%20i%20own&lt;/url&gt;
        &lt;/tag&gt;
        ...
    &lt;/toptags&gt;
&lt;/lfm&gt;</pre>
                                        Hover over the underlined tags and attributes to get detailed information.
                                    </div>
                                
                                    <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>album.removeTag</h1>
    <div class="wsdescription">
        Remove a user's tag from an album.
    </div>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">artist</span> (Required) : The artist name<br />
                <span class="param">album</span> (Required) : The album name<br />
                <span class="param">tag</span> (Required) : A single user tag to remove from this album.<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                  <span class="param">api_sig</span> (Required) : A Last.fm method signature. See <a href="/api/authentication">authentication</a> for more information.<br />
                     <span class="param">sk</span> (Required) : A session key generated by authenticating a user via the authentication protocol.
                              <h2>Auth</h2>
                                     
                           This service requires authentication. Please see our <a href="/api/authentication">authentication</a> how-to.<br/>
                                        This is a <b>write</b> service and must be accessed with an HTTP POST request. All parameters should be sent in the POST body, including the 'method' parameter. See <a href="/api/rest">rest requests</a> for more information.
            l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;lfm status=&quot;ok&quot;&gt;
&lt;/lfm&gt;</pre>
                                    </div>
                                
                                    <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>album.search</h1>
    <div class="wsdescription">
        Search for an album by name. Returns album matches sorted by relevance.
    </div>
        <p class="sampleurl">
    e.g. <a href="http://ws.audioscrobbler.com/2.0/?method=album.search&album=believe&api_key=b25b959554ed76058ac220b7b2e0a026">http://ws.audioscrobbler.com/2.0/?method=album.search&album=believe&api_key=b25b959554ed76058ac...</a> 
    </p>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">limit</span> (Optional) : The number of results to fetch per page. Defaults to 30.<br />
                <span class="param">page</span> (Optional) : The page number to fetch.  Defaults to first page.<br />
                <span class="param">album</span> (Required) : The album name<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                     <h2>Auth</h2>
                                     
                           This service does <b>not</b> require authentication.
                        l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;results for=&quot;believe&quot;&gt;
  &lt;opensearch:Query role=&quot;request&quot; searchTerms=&quot;believe&quot; startPage=&quot;1&quot;/&gt;
  &lt;opensearch:totalResults&gt;734&lt;/opensearch:totalResults&gt;
  &lt;opensearch:startIndex&gt;0&lt;/opensearch:startIndex&gt;
  &lt;opensearch:itemsPerPage&gt;20&lt;/opensearch:itemsPerPage&gt;
  &lt;albummatches&gt;
    &lt;album&gt;
      &lt;name&gt;Make Believe&lt;/name&gt;
      &lt;artist&gt;Weezer&lt;/artist&gt;
      &lt;id&gt;2025180&lt;/id&gt;
      &lt;url&gt;http://www.last.fm/music/Weezer/Make+Believe&lt;/url&gt;
      &lt;image size=&quot;small&quot;&gt;http://userserve-ak.last.fm/serve/34/8673675.jpg&lt;/image&gt;
      &lt;image size=&quot;medium&quot;&gt;http://userserve-ak.last.fm/serve/64/8673675.jpg&lt;/image&gt;
      &lt;image size=&quot;large&quot;&gt;http://userserve-ak.last.fm/serve/126/8673675.jpg&lt;/image&gt;
      &lt;streamable&gt;0&lt;/streamable&gt;
    &lt;/album&gt;
    ...
  &lt;/albummatches&gt;
&lt;/results&gt;</pre>
                                    </div>
                                
                                    <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>album.share</h1>
    <div class="wsdescription">
        Share an album with one or more Last.fm users or other friends.
    </div>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">artist</span> (Required) : An artist name.<br />
                <span class="param">album</span> (Required) : An album name.<br />
                <span class="param">public</span> (Optional): Optionally show in the sharing users activity feed. Defaults to 0 (false).<br />
                <span class="param">message</span> (Optional): An optional message to send with the recommendation. If not supplied a default message will be used.<br />
                <span class="param">recipient</span> (Required): Email Address | Last.fm Username - A comma delimited list of email addresses or Last.fm usernames. Maximum is 10.<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                  <span class="param">api_sig</span> (Required) : A Last.fm method signature. See <a href="/api/authentication">authentication</a> for more information.<br />
                     <span class="param">sk</span> (Required) : A session key generated by authenticating a user via the authentication protocol.
                              <h2>Auth</h2>
                                     
                           This service requires authentication. Please see our <a href="/api/authentication">authentication</a> how-to.<br/>
                                        This is a <b>write</b> service and must be accessed with an HTTP POST request. All parameters should be sent in the POST body, including the 'method' parameter. See <a href="/api/rest">rest requests</a> for more information.
            l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;lfm status=&quot;ok&quot;&gt;
&lt;/lfm&gt;</pre>
                                    </div>
                                
                                    <h2>Errors</h2>
            <ul>
                                    <li><span class="param">6</span> : Invalid artist name supplied</li>
                                                <li><span class="param">8</span> : Operation Failed - Server Error. Please try again later.</li>
                                                <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>artist.addTags</h1>
    <div class="wsdescription">
        Tag an artist with one or more user supplied tags.
    </div>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">artist</span> (Required) : The artist name<br />
                <span class="param">tags</span> (Required) : A comma delimited list of user supplied tags to apply to this artist. Accepts a maximum of 10 tags.<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                  <span class="param">api_sig</span> (Required) : A Last.fm method signature. See <a href="/api/authentication">authentication</a> for more information.<br />
                     <span class="param">sk</span> (Required) : A session key generated by authenticating a user via the authentication protocol.
                              <h2>Auth</h2>
                                     
                           This service requires authentication. Please see our <a href="/api/authentication">authentication</a> how-to.<br/>
                                        This is a <b>write</b> service and must be accessed with an HTTP POST request. All parameters should be sent in the POST body, including the 'method' parameter. See <a href="/api/rest">rest requests</a> for more information.
            l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;lfm status=&quot;ok&quot;&gt;
&lt;/lfm&gt;</pre>
                                    </div>
                                
                                    <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>artist.getCorrection</h1>
    <div class="wsdescription">
        Use the last.fm corrections data to check whether the supplied artist has a
correction to a canonical artist
    </div>
        <p class="sampleurl">
    e.g. <a href="http://ws.audioscrobbler.com/2.0/?method=artist.getcorrection&artist=Guns and Roses&api_key=b25b959554ed76058ac220b7b2e0a026">http://ws.audioscrobbler.com/2.0/?method=artist.getcorrection&artist=Guns and...</a> 
    </p>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">artist</span> (Required) : The artist name to correct.<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                     <h2>Auth</h2>
                                     
                           This service does <b>not</b> require authentication.
                        l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;corrections&gt;
  &lt;correction index=&quot;0&quot;&gt;
    &lt;artist&gt;
      &lt;name&gt;Guns N' Roses&lt;/name&gt;
      &lt;mbid&gt;eeb1195b-f213-4ce1-b28c-8565211f8e43&lt;/mbid&gt;
      &lt;url&gt;http://www.last.fm/music/Guns+N%27+Roses&lt;/url&gt;
    &lt;/artist&gt;
  &lt;/correction&gt;
&lt;/corrections&gt;</pre>
                                    </div>
                                
                                    <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>artist.getEvents</h1>
    <div class="wsdescription">
        Get a list of upcoming events for this artist. Easily integratable into
calendars, using the ical standard (see feeds section below).
    </div>
        <p class="sampleurl">
    e.g. <a href="http://ws.audioscrobbler.com/2.0/?method=artist.getevents&artist=Cher&api_key=b25b959554ed76058ac220b7b2e0a026">http://ws.audioscrobbler.com/2.0/?method=artist.getevents&artist=Cher&api_key=b25b959554ed76058...</a> 
    </p>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">artist</span> (Required (unless mbid)] : The artist name<br />
                <span class="param">mbid</span> (Optional) : The musicbrainz id for the artist<br />
                <span class="param">autocorrect[0|1]</span> (Optional) : Transform misspelled artist names into correct artist names, returning the correct version instead.  The corrected artist name will be returned in the response.<br />
                <span class="param">limit</span> (Optional) : The number of results to fetch per page. Defaults to 50.<br />
                <span class="param">page</span> (Optiona) : The page number to fetch.  Defaults to first page.<br />
                <span class="param">festivalsonly[0|1]</span> (Optional) : Whether only festivals should be returned, or all events.<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                     <h2>Auth</h2>
                                     
                           This service does <b>not</b> require authentication.
                        l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;events artist=&quot;Cher&quot; xmlns:geo=&quot;http://www.w3.org/2003/01/geo/wgs84_pos#&quot; total=&quot;4&quot;&gt;
  &lt;event&gt;
    &lt;id&gt;599858&lt;/id&gt;
    &lt;title&gt;Cher&lt;/title&gt;
    &lt;artists&gt;
      &lt;artist&gt;Cher&lt;/artist&gt;
      &lt;headliner&gt;Cher&lt;/headliner&gt;
    &lt;/artists&gt;
    &lt;venue&gt;
      &lt;name&gt;The Colosseum at Caesars Palace&lt;/name&gt;
      &lt;location&gt;
        &lt;city&gt;Las Vegas&lt;/city&gt;
        &lt;country&gt;United States&lt;/country&gt;
        &lt;street&gt;&lt;/street&gt;
        &lt;postalcode&gt;&lt;/postalcode&gt;
        &lt;geo:point&gt;
          &lt;geo:lat&gt;36.2265501474709&lt;/geo:lat&gt;
          &lt;geo:long&gt;-115.0048828125&lt;/geo:long&gt;
        &lt;/geo:point&gt;
        &lt;timezone&gt;PST&lt;/timezone&gt;
      &lt;/location&gt;
      &lt;url&gt;http://www.last.fm/venue/8841108&lt;/url&gt;
    &lt;/venue&gt;
    &lt;startDate&gt;Sat, 16 Aug 2008&lt;/startDate&gt;
    &lt;startTime&gt;19:30&lt;/startTime&gt;
    &lt;description&gt;&lt;/description&gt;
    &lt;image size=&quot;small&quot;&gt;...&lt;/image&gt;
    &lt;image size=&quot;medium&quot;&gt;...&lt;/image&gt;
    &lt;image size=&quot;large&quot;&gt;...&lt;/image&gt;
    &lt;attendance&gt;42&lt;/attendance&gt;
    &lt;reviews&gt;0&lt;/reviews&gt;
    &lt;tag&gt;lastfm:event=669027&lt;/tag&gt;
    &lt;url&gt;http://www.last.fm/event/599858&lt;/url&gt;
    &lt;website&gt;http://...&lt;/website&gt;
    &lt;tickets&gt;
      &lt;ticket supplier=&quot;...&quot;&gt;http://...&lt;/ticket&gt;
      ...
    &lt;/tickets&gt;
  &lt;/event&gt;
  ...
&lt;/events&gt;</pre>
                                    </div>
                                
                    <h2>Other Formats</h2>
                            Also available as a feed in <b>rss,ical</b> formats                <p>
                                    e.g. <a href="http://ws.audioscrobbler.com/2.0/artist/cher/events.rss">http://ws.audioscrobbler.com/2.0/artist/cher/events.rss</a><br />
                                    e.g. <a href="http://ws.audioscrobbler.com/2.0/artist/cher/events.ical">http://ws.audioscrobbler.com/2.0/artist/cher/events.ical</a><br />
                                </p>
                                                <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>artist.getInfo</h1>
    <div class="wsdescription">
        Get the metadata for an artist. Includes biography.
    </div>
        <p class="sampleurl">
    e.g. <a href="http://ws.audioscrobbler.com/2.0/?method=artist.getinfo&artist=Cher&api_key=b25b959554ed76058ac220b7b2e0a026">http://ws.audioscrobbler.com/2.0/?method=artist.getinfo&artist=Cher&api_key=b25b959554ed76058ac...</a> 
    </p>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">artist</span> (Required (unless mbid)] : The artist name<br />
                <span class="param">mbid</span> (Optional) : The musicbrainz id for the artist<br />
                <span class="param">lang</span> (Optional) : The language to return the biography in, expressed as an ISO 639 alpha-2 code.<br />
                <span class="param">autocorrect[0|1]</span> (Optional) : Transform misspelled artist names into correct artist names, returning the correct version instead.  The corrected artist name will be returned in the response.<br />
                <span class="param">username</span> (Optional) : The username for the context of the request. If supplied, the user's playcount for this artist is included in the response.<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                     <h2>Auth</h2>
                                     
                           This service does <b>not</b> require authentication.
                        l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;artist&gt;
  &lt;name&gt;Cher&lt;/name&gt;
  &lt;mbid&gt;bfcc6d75-a6a5-4bc6-8282-47aec8531818&lt;/mbid&gt;
  &lt;url&gt;http://www.last.fm/music/Cher&lt;/url&gt;
  &lt;image size=&quot;small&quot;&gt;http://userserve-ak.last.fm/serve/50/285717.jpg&lt;/image&gt;
  &lt;image size=&quot;medium&quot;&gt;http://userserve-ak.last.fm/serve/85/285717.jpg&lt;/image&gt;
  &lt;image size=&quot;large&quot;&gt;http://userserve-ak.last.fm/serve/160/285717.jpg&lt;/image&gt;
  &lt;streamable&gt;1&lt;/streamable&gt;
  &lt;stats&gt;
    &lt;listeners&gt;196440&lt;/listeners&gt;
    &lt;plays&gt;1599101&lt;/plays&gt;
  &lt;/stats&gt;
  &lt;similar&gt;
    &lt;artist&gt;
      &lt;name&gt;Madonna&lt;/name&gt;
      &lt;url&gt;http://www.last.fm/music/Madonna&lt;/url&gt;
      &lt;image size=&quot;small&quot;&gt;http://userserve-ak.last.fm/serve/50/5112299.jpg&lt;/image&gt;
      &lt;image size=&quot;medium&quot;&gt;http://userserve-ak.last.fm/serve/85/5112299.jpg&gt;&lt;/image&gt;
      &lt;image size=&quot;large&quot;&gt;http://userserve-ak.last.fm/serve/160/5112299.jpg&lt;/image&gt;
    &lt;/artist&gt;
    ...
  &lt;/similar&gt;
  &lt;tags&gt;
    &lt;tag&gt;
      &lt;name&gt;pop&lt;/name&gt;
      &lt;url&gt;http://www.last.fm/tag/pop&lt;/url&gt;
    &lt;/tag&gt;
    ...
  &lt;/tags&gt;
  &lt;bio&gt;
    &lt;published&gt;Thu, 13 Mar 2008 03:59:18 +0000&lt;/published&gt;
    &lt;summary&gt;...&lt;/summary&gt;
    &lt;content&gt;...&lt;/content&gt;
  &lt;/bio&gt;
&lt;/artist&gt;</pre>
                                    </div>
                                
                                    <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>artist.getPastEvents</h1>
    <div class="wsdescription">
        Get a paginated list of all the events this artist has played at in the
past.
    </div>
        <p class="sampleurl">
    e.g. <a href="http://ws.audioscrobbler.com/2.0/?method=artist.getpastevents&artist=cher&api_key=b25b959554ed76058ac220b7b2e0a026">http://ws.audioscrobbler.com/2.0/?method=artist.getpastevents&artist=cher&api_key=b25b959554ed7...</a> 
    </p>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">artist</span> (Required (unless mbid)] :The name of the artist you would like to fetch event listings for.<br />
                <span class="param">mbid</span> (Optional) : The musicbrainz id for the artist<br />
                <span class="param">page</span> (Optional) :The page of results to return.<br />
                <span class="param">autocorrect[0|1]</span> (Optional) : Transform misspelled artist names into correct artist names, returning the correct version instead.  The corrected artist name will be returned in the response.<br />
                <span class="param">limit</span> (Optional) : The number of results to fetch per page. Defaults to 50.<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                     <h2>Auth</h2>
                                     
                           This service does <b>not</b> require authentication.
                        l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;events artist=&quot;Cher&quot; url=&quot;http://www.last.fm/music/Cher/+events&quot; xmlns:geo=&quot;http://www.w3.org/2003/01/geo/wgs84_pos#&quot; page=&quot;1&quot; perPage=&quot;50&quot; total=&quot;41&quot; totalPages=&quot;1&quot;&gt;
  &lt;event xmlns:geo=&quot;http://www.w3.org/2003/01/geo/wgs84_pos#&quot;&gt;
    &lt;id&gt;1196301&lt;/id&gt;
    &lt;title&gt;pRIvate&lt;/title&gt;
    &lt;artists&gt;
      &lt;artist&gt;CSS&lt;/artist&gt;
      &lt;artist&gt;Madonna&lt;/artist&gt;
      &lt;artist&gt;Britney Spears&lt;/artist&gt;
      &lt;artist&gt;Lady GaGa&lt;/artist&gt;
      &lt;artist&gt;Cher&lt;/artist&gt;
      &lt;artist&gt;RuPaul&lt;/artist&gt;
      &lt;headliner&gt;CSS&lt;/headliner&gt;
    &lt;/artists&gt;
    &lt;venue&gt;
      &lt;id&gt;9064369&lt;/id&gt;
      &lt;name&gt;Berlusconni´s&lt;/name&gt;
      &lt;location&gt;
        &lt;city&gt;São Paulo&lt;/city&gt;
        &lt;country&gt;Brazil&lt;/country&gt;
        &lt;street&gt;&lt;/street&gt;
        &lt;postalcode&gt;&lt;/postalcode&gt;
        &lt;geo:point&gt;
          &lt;geo:lat&gt;-23.5576930875657&lt;/geo:lat&gt;
          &lt;geo:long&gt;-46.669921875&lt;/geo:long&gt;
        &lt;/geo:point&gt;
      &lt;/location&gt;
      &lt;url&gt;http://www.last.fm/venue/9064369+Berlusconni%C2%B4s&lt;/url&gt;
      &lt;website&gt;&lt;/website&gt;
      &lt;phonenumber&gt;&lt;/phonenumber&gt;
      &lt;image size=&quot;small&quot;&gt;&lt;/image&gt;
      &lt;image size=&quot;medium&quot;&gt;&lt;/image&gt;
      &lt;image size=&quot;large&quot;&gt;&lt;/image&gt;
      &lt;image size=&quot;extralarge&quot;&gt;&lt;/image&gt;
      &lt;image size=&quot;mega&quot;&gt;&lt;/image&gt;
    &lt;/venue&gt;
    &lt;startDate&gt;Fri, 28 Aug 2009 04:42:01&lt;/startDate&gt;
    &lt;description&gt;
      &lt;![CDATA[&lt;div class=&quot;bbcode&quot;&gt;Rua Nestor Pestana, 189&lt;/div&gt;]]&gt;
    &lt;/description&gt;
    &lt;image size=&quot;small&quot;&gt;http://userserve-ak.last.fm/serve/34/8834875.jpg&lt;/image&gt;
    &lt;image size=&quot;medium&quot;&gt;http://userserve-ak.last.fm/serve/64/8834875.jpg&lt;/image&gt;
    &lt;image size=&quot;large&quot;&gt;http://userserve-ak.last.fm/serve/126/8834875.jpg&lt;/image&gt;
    &lt;image size=&quot;extralarge&quot;&gt;http://userserve-ak.last.fm/serve/252/8834875.jpg&lt;/image&gt;
    &lt;attendance&gt;1&lt;/attendance&gt;
    &lt;reviews&gt;0&lt;/reviews&gt;
    &lt;tag&gt;lastfm:event=1196301&lt;/tag&gt;
    &lt;url&gt;http://www.last.fm/event/1196301+pRIvate&lt;/url&gt;
    &lt;website&gt;&lt;/website&gt;
    &lt;tickets&gt;&lt;/tickets&gt;
    &lt;cancelled&gt;0&lt;/cancelled&gt;
  &lt;/event&gt;
&lt;/events&gt;</pre>
                                    </div>
                                
                    <h2>Other Formats</h2>
                            Also available as a feed in <b>rss,ical</b> formats                <p>
                                    e.g. <a href="http://ws.audioscrobbler.com/2.0/artist/cher/pastevents.rss">http://ws.audioscrobbler.com/2.0/artist/cher/pastevents.rss</a><br />
                                    e.g. <a href="http://ws.audioscrobbler.com/2.0/artist/cher/pastevents.ical">http://ws.audioscrobbler.com/2.0/artist/cher/pastevents.ical</a><br />
                                </p>
                                                <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>artist.getPodcast</h1>
    <div class="wsdescription">
        Get a podcast of free mp3s based on an artist
    </div>
        <p class="sampleurl">
    e.g. <a href="http://ws.audioscrobbler.com/2.0/?method=artist.getpodcast&artist=cher&api_key=b25b959554ed76058ac220b7b2e0a026">http://ws.audioscrobbler.com/2.0/?method=artist.getpodcast&artist=cher&api_key=b25b959554ed7605...</a> 
    </p>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">artist</span> (Required (unless mbid)] : The artist name<br />
                <span class="param">mbid</span> (Optional) : The musicbrainz id for the artist<br />
                <span class="param">autocorrect[0|1]</span> (Optional) : Transform misspelled artist names into correct artist names, returning the correct version instead.  The corrected artist name will be returned in the response.<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                     <h2>Auth</h2>
                                     
                           This service does <b>not</b> require authentication.
                        l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;rss xmlns:itunes=&quot;http://www.itunes.com/dtds/podcast-1.0.dtd&quot; version=&quot;2.0&quot;&gt;
&lt;channel&gt;
  &lt;title&gt;Free pornophonique MP3s&lt;/title&gt;
  &lt;link&gt;http://www.last.fm/music/pornophonique&lt;/link&gt;
  &lt;description&gt;Free pornophonique MP3s from Last.fm&lt;/description&gt;
  &lt;item&gt;
    &lt;title&gt;pornophonique - Rock'n'roll Hall Of Fame&lt;/title&gt;
    &lt;guid isPermaLink=&quot;false&quot;&gt;http://www.last.fm/music/pornophonique/_/Rock%27n%27roll+Hall+Of+Fame&lt;/guid&gt;
    &lt;itunes:author&gt;pornophonique&lt;/itunes:author&gt;
    &lt;enclosure url=&quot;http://freedownloads.last.fm/download/120677617/Rock%2527n%2527roll%2BHall%2BOf%2BFame.mp3&quot; length=&quot;3872000&quot; type=&quot;audio/mpeg&quot; /&gt;
    &lt;description&gt;pornophonique - Rock'n'roll Hall Of Fame (4:02) 3.7 MB&lt;/description&gt;
    &lt;link&gt;http://www.last.fm/music/pornophonique/_/Rock%27n%27roll+Hall+Of+Fame&lt;/link&gt;
  &lt;/item&gt;
  &lt;item&gt;
    &lt;title&gt;pornophonique - 1/2 player game&lt;/title&gt;
    &lt;guid isPermaLink=&quot;false&quot;&gt;http://www.last.fm/music/pornophonique/_/1%252F2%2Bplayer%2Bgame&lt;/guid&gt;
    &lt;itunes:author&gt;pornophonique&lt;/itunes:author&gt;
    &lt;enclosure url=&quot;http://freedownloads.last.fm/download/113567641/1%252F2%2Bplayer%2Bgame.mp3&quot; length=&quot;3664000&quot; type=&quot;audio/mpeg&quot; /&gt;
    &lt;description&gt;pornophonique - 1/2 player game (3:49) 3.5 MB&lt;/description&gt;
    &lt;link&gt;http://www.last.fm/music/pornophonique/_/1%252F2%2Bplayer%2Bgame&lt;/link&gt;
  &lt;/item&gt;
&lt;/channel&gt;</pre>
                                    </div>
                                
                    <h2>Other Formats</h2>
                            Also available as a feed in <b>rss</b> format                <p>
                                    e.g. <a href="http://ws.audioscrobbler.com/2.0/artist/cher/podcast.rss">http://ws.audioscrobbler.com/2.0/artist/cher/podcast.rss</a><br />
                                </p>
                                                <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>artist.getShouts</h1>
    <div class="wsdescription">
        Get shouts for this artist. Also available as an rss feed.
    </div>
        <p class="sampleurl">
    e.g. <a href="http://ws.audioscrobbler.com/2.0/?method=artist.getshouts&artist=cher&api_key=b25b959554ed76058ac220b7b2e0a026">http://ws.audioscrobbler.com/2.0/?method=artist.getshouts&artist=cher&api_key=b25b959554ed76058...</a> 
    </p>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">artist</span> (Required (unless mbid)] : The artist name<br />
                <span class="param">mbid</span> (Optional) : The musicbrainz id for the artist<br />
                <span class="param">limit</span> (Optional) : The number of results to fetch per page. Defaults to 50.<br />
                <span class="param">autocorrect[0|1]</span> (Optional) : Transform misspelled artist names into correct artist names, returning the correct version instead.  The corrected artist name will be returned in the response.<br />
                <span class="param">page</span> (Optional) : The page number to fetch.  Defaults to first page.<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                     <h2>Auth</h2>
                                     
                           This service does <b>not</b> require authentication.
                        l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;shouts artist=&quot;Cher&quot; total=&quot;495&quot;&gt;
  &lt;shout&gt;
    &lt;body&gt;Blah&lt;/body&gt;
    &lt;author&gt;joanofarctan&lt;/author&gt;
    &lt;date&gt;Fri, 12 Dec 2008 13:20:41&lt;/date&gt;
  &lt;/shout&gt;
  ...
&lt;/shouts&gt;</pre>
                                    </div>
                                
                    <h2>Other Formats</h2>
                            Also available as a feed in <b>rss</b> format                <p>
                                    e.g. <a href="http://ws.audioscrobbler.com/2.0/artist/cher/shouts.rss">http://ws.audioscrobbler.com/2.0/artist/cher/shouts.rss</a><br />
                                </p>
                                                <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>artist.getSimilar</h1>
    <div class="wsdescription">
        Get all the artists similar to this artist
    </div>
        <p class="sampleurl">
    e.g. <a href="http://ws.audioscrobbler.com/2.0/?method=artist.getsimilar&artist=cher&api_key=b25b959554ed76058ac220b7b2e0a026">http://ws.audioscrobbler.com/2.0/?method=artist.getsimilar&artist=cher&api_key=b25b959554ed7605...</a> 
    </p>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">limit</span> (Optional) : Limit the number of similar artists returned<br />
                <span class="param">artist</span> (Required (unless mbid)] : The artist name<br />
                <span class="param">autocorrect[0|1]</span> (Optional) : Transform misspelled artist names into correct artist names, returning the correct version instead.  The corrected artist name will be returned in the response.<br />
                <span class="param">mbid</span> (Optional) : The musicbrainz id for the artist<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                     <h2>Auth</h2>
                                     
                           This service does <b>not</b> require authentication.
                        l
            <h2>Sample Response</h2>
                                                                                                                                                                                                                                            <div id="sample">
                    <pre>&lt;similarartists artist=&quot;Cher&quot;&gt;
  &lt;artist&gt;
    &lt;name&gt;Sonny &amp; Cher&lt;/name&gt;
    &lt;mbid&gt;3d6e4b6d-2700-458c-9722-9021965a8164&lt;/mbid&gt;
    &lt;<span class="tagDescription" title="A similarity value between 0 (not similar) and 1 (very similar)">match</span>&gt;1&lt;/match&gt;
    &lt;url&gt;www.last.fm/music/Sonny%2B%2526%2BCher&lt;/url&gt;
    &lt;image size=&quot;small&quot;&gt;http://userserve-ak.last.fm/serve/34/71168880.png&lt;/image&gt;
    &lt;image size=&quot;medium&quot;&gt;http://userserve-ak.last.fm/serve/64/71168880.png&lt;/image&gt;
    &lt;image size=&quot;large&quot;&gt;http://userserve-ak.last.fm/serve/126/71168880.png&lt;/image&gt;
    &lt;image size=&quot;extralarge&quot;&gt;http://userserve-ak.last.fm/serve/252/71168880.png&lt;/image&gt;
    &lt;image size=&quot;mega&quot;&gt;http://userserve-ak.last.fm/serve/500/71168880/Sonny++Cher.png&lt;/image&gt;
    &lt;streamable&gt;1&lt;/streamable&gt;
  &lt;/artist&gt;
  ...
&lt;/similarartists&gt;</pre>
                                        Hover over the underlined tags and attributes to get detailed information.
                                    </div>
                                
                    <h2>Other Formats</h2>
                            Also available as a feed in <b>txt</b> format                <p>
                                    e.g. <a href="http://ws.audioscrobbler.com/2.0/artist/cher/similar.txt">http://ws.audioscrobbler.com/2.0/artist/cher/similar.txt</a><br />
                                </p>
                                                <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>artist.getTags</h1>
    <div class="wsdescription">
        Get the tags applied by an individual user to an artist on Last.fm. If
accessed as an authenticated service /and/ you don't supply a user
parameter then this service will return tags for the authenticated user.
  To retrieve the list of top tags applied to an artist by all users use
artist.getTopTags.
    </div>
        <p class="sampleurl">
    e.g. <a href="http://ws.audioscrobbler.com/2.0/?method=artist.getTags&artist=Red%20Hot%20Chili%20Peppers&user=RJ&api_key=b25b959554ed76058ac220b7b2e0a026">http://ws.audioscrobbler.com/2.0/?method=artist.getTags&artist=Red%20Hot%20Chili%20Peppers&user...</a> 
    </p>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">artist</span> (Required (unless mbid)] : The artist name<br />
                <span class="param">mbid</span> (Optional) : The musicbrainz id for the artist<br />
                <span class="param">user</span> (Optional) : If called in non-authenticated mode you must specify the user to look up<br />
                <span class="param">autocorrect[0|1]</span> (Optional) : Transform misspelled artist names into correct artist names, returning the correct version instead.  The corrected artist name will be returned in the response.<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                     <h2>Auth</h2>
                                     
                           This service does <b>not</b> require authentication.
                        l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;tags artist=&quot;Sally Shapiro&quot;&gt;
  &lt;tag&gt;
    &lt;name&gt;italo&lt;/name&gt;
    &lt;url&gt;http://www.last.fm/tag/italo&lt;/url&gt;
  &lt;/tag&gt;
  ...
&lt;/tags&gt;</pre>
                                    </div>
                                
                                    <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>artist.getTopAlbums</h1>
    <div class="wsdescription">
        Get the top albums for an artist on Last.fm, ordered by popularity.
    </div>
        <p class="sampleurl">
    e.g. <a href="http://ws.audioscrobbler.com/2.0/?method=artist.gettopalbums&artist=cher&api_key=b25b959554ed76058ac220b7b2e0a026">http://ws.audioscrobbler.com/2.0/?method=artist.gettopalbums&artist=cher&api_key=b25b959554ed76...</a> 
    </p>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">artist</span> (Required (unless mbid)] : The artist name<br />
                <span class="param">mbid</span> (Optional) : The musicbrainz id for the artist<br />
                <span class="param">autocorrect[0|1]</span> (Optional) : Transform misspelled artist names into correct artist names, returning the correct version instead.  The corrected artist name will be returned in the response.<br />
                <span class="param">page</span> (Optional) : The page number to fetch.  Defaults to first page.<br />
                <span class="param">limit</span> (Optional) : The number of results to fetch per page. Defaults to 50.<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                     <h2>Auth</h2>
                                     
                           This service does <b>not</b> require authentication.
                        l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;topalbums artist=&quot;Cher&quot;&gt;
  &lt;album rank=&quot;1&quot;&gt;
    &lt;name&gt;Believe&lt;/name&gt;
    &lt;mbid&gt;61bf0388-b8a9-48f4-81d1-7eb02706dfb0&lt;/mbid&gt;
    &lt;listeners&gt;24486&lt;/listeners&gt;
    &lt;url&gt;http://www.last.fm/music/Cher/Believe&lt;/url&gt;
    &lt;image size=&quot;small&quot;&gt;...&lt;/image&gt;
    &lt;image size=&quot; medium&quot;&gt;...&lt;/image&gt;
    &lt;image size=&quot;large&quot;&gt;...&lt;/image&gt;
  &lt;/album&gt;
  ...
&lt;/topalbums&gt;</pre>
                                    </div>
                                
                                    <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>artist.getTopFans</h1>
    <div class="wsdescription">
        Get the top fans for an artist on Last.fm, based on listening data.
    </div>
        <p class="sampleurl">
    e.g. <a href="http://ws.audioscrobbler.com/2.0/?method=artist.gettopfans&artist=cher&api_key=b25b959554ed76058ac220b7b2e0a026">http://ws.audioscrobbler.com/2.0/?method=artist.gettopfans&artist=cher&api_key=b25b959554ed7605...</a> 
    </p>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">artist</span> (Required (unless mbid)] : The artist name<br />
                <span class="param">mbid</span> (Optional) : The musicbrainz id for the artist<br />
                <span class="param">autocorrect[0|1]</span> (Optional) : Transform misspelled artist names into correct artist names, returning the correct version instead.  The corrected artist name will be returned in the response.<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                     <h2>Auth</h2>
                                     
                           This service does <b>not</b> require authentication.
                        l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;topfans artist=&quot;Cher&quot;&gt;
  &lt;user&gt;
    &lt;name&gt;Haldeth&lt;/name&gt;
    &lt;url&gt;http://www.last.fm/user/Haldeth/&lt;/url&gt;
    &lt;image size=&quot;small&quot;&gt;http://userserve-ak.last.fm/serve/50/2032958.gif&lt;/image&gt;
    &lt;image size=&quot;medium&quot;&gt;http://userserve-ak.last.fm/serve/85/2032958.gif&lt;/image&gt;
    &lt;image size=&quot;large&quot;&gt;http://userserve-ak.last.fm/serve/160/2032958.gif&lt;/image&gt;
    &lt;weight&gt;114242000&lt;/weight&gt;
  &lt;/user&gt;
  ...
&lt;/topfans&gt;</pre>
                                    </div>
                                
                                    <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>artist.getTopTags</h1>
    <div class="wsdescription">
        Get the top tags for an artist on Last.fm, ordered by popularity.
    </div>
        <p class="sampleurl">
    e.g. <a href="http://ws.audioscrobbler.com/2.0/?method=artist.gettoptags&artist=cher&api_key=b25b959554ed76058ac220b7b2e0a026">http://ws.audioscrobbler.com/2.0/?method=artist.gettoptags&artist=cher&api_key=b25b959554ed7605...</a> 
    </p>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">artist</span> (Required (unless mbid)] : The artist name<br />
                <span class="param">mbid</span> (Optional) : The musicbrainz id for the artist<br />
                <span class="param">autocorrect[0|1]</span> (Optional) : Transform misspelled artist names into correct artist names, returning the correct version instead.  The corrected artist name will be returned in the response.<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                     <h2>Auth</h2>
                                     
                           This service does <b>not</b> require authentication.
                        l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;toptags artist=&quot;Cher&quot;&gt;
  &lt;tag&gt;
    &lt;name&gt;pop&lt;/name&gt;
    &lt;url&gt;http://www.last.fm/tag/pop&lt;/url&gt;
  &lt;/tag&gt;
  ...
&lt;/toptags&gt;</pre>
                                    </div>
                                
                                    <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>artist.getTopTracks</h1>
    <div class="wsdescription">
        Get the top tracks by an artist on Last.fm, ordered by popularity
    </div>
        <p class="sampleurl">
    e.g. <a href="http://ws.audioscrobbler.com/2.0/?method=artist.gettoptracks&artist=cher&api_key=b25b959554ed76058ac220b7b2e0a026">http://ws.audioscrobbler.com/2.0/?method=artist.gettoptracks&artist=cher&api_key=b25b959554ed76...</a> 
    </p>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">artist</span> (Required (unless mbid)] : The artist name<br />
                <span class="param">mbid</span> (Optional) : The musicbrainz id for the artist<br />
                <span class="param">autocorrect[0|1]</span> (Optional) : Transform misspelled artist names into correct artist names, returning the correct version instead.  The corrected artist name will be returned in the response.<br />
                <span class="param">page</span> (Optional) : The page number to fetch.  Defaults to first page.<br />
                <span class="param">limit</span> (Optional) : The number of results to fetch per page. Defaults to 50.<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                     <h2>Auth</h2>
                                     
                           This service does <b>not</b> require authentication.
                        l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;toptracks artist=&quot;Cher&quot;&gt;
  &lt;track rank=&quot;1&quot;&gt;
    &lt;name&gt;Believe&lt;/name&gt;
    &lt;mbid/&gt;
    &lt;playcount&gt;56325&lt;/playcount&gt;
    &lt;listeners&gt;23217&lt;/listeners&gt;
    &lt;url&gt;http://www.last.fm/music/Cher/_/Believe&lt;/url&gt;
    &lt;image size=&quot;small&quot;&gt;...&lt;/image&gt;
    &lt;image size=&quot; medium&quot;&gt;...&lt;/image&gt;
    &lt;image size=&quot;large&quot;&gt;...&lt;/image&gt;
  &lt;/track&gt;
  ...
&lt;/toptracks&gt;</pre>
                                    </div>
                                
                    <h2>Other Formats</h2>
                            Also available as a feed in <b>xspf</b> format                <p>
                                    e.g. <a href="http://ws.audioscrobbler.com/2.0/artist/cher/toptracks.xspf">http://ws.audioscrobbler.com/2.0/artist/cher/toptracks.xspf</a><br />
                                </p>
                                                <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>artist.removeTag</h1>
    <div class="wsdescription">
        Remove a user's tag from an artist.
    </div>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">artist</span> (Required) : The artist name<br />
                <span class="param">tag</span> (Required) : A single user tag to remove from this artist.<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                  <span class="param">api_sig</span> (Required) : A Last.fm method signature. See <a href="/api/authentication">authentication</a> for more information.<br />
                     <span class="param">sk</span> (Required) : A session key generated by authenticating a user via the authentication protocol.
                              <h2>Auth</h2>
                                     
                           This service requires authentication. Please see our <a href="/api/authentication">authentication</a> how-to.<br/>
                                        This is a <b>write</b> service and must be accessed with an HTTP POST request. All parameters should be sent in the POST body, including the 'method' parameter. See <a href="/api/rest">rest requests</a> for more information.
            l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;lfm status=&quot;ok&quot;&gt;
&lt;/lfm&gt;</pre>
                                    </div>
                                
                                    <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>artist.search</h1>
    <div class="wsdescription">
        Search for an artist by name. Returns artist matches sorted by relevance.
    </div>
        <p class="sampleurl">
    e.g. <a href="http://ws.audioscrobbler.com/2.0/?method=artist.search&artist=cher&api_key=b25b959554ed76058ac220b7b2e0a026">http://ws.audioscrobbler.com/2.0/?method=artist.search&artist=cher&api_key=b25b959554ed76058ac2...</a> 
    </p>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">limit</span> (Optional) : The number of results to fetch per page. Defaults to 30.<br />
                <span class="param">page</span> (Optional) : The page number to fetch.  Defaults to first page.<br />
                <span class="param">artist</span> (Required) : The artist name<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                     <h2>Auth</h2>
                                     
                           This service does <b>not</b> require authentication.
                        l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;results for=&quot;cher&quot; xmlns:opensearch=&quot;http://a9.com/-/spec/opensearch/1.1/&quot;&gt;
  &lt;opensearch:Query role=&quot;request&quot; searchTerms=&quot;cher&quot; startPage=&quot;1&quot;/&gt;
  &lt;opensearch:totalResults&gt;386&lt;/opensearch:totalResults&gt;
  &lt;opensearch:startIndex&gt;0&lt;/opensearch:startIndex&gt;
  &lt;opensearch:itemsPerPage&gt;20&lt;/opensearch:itemsPerPage&gt;
  &lt;artistmatches&gt;
    &lt;artist&gt;
      &lt;name&gt;Cher&lt;/name&gt;
      &lt;mbid&gt;bfcc6d75-a6a5-4bc6-8282-47aec8531818&lt;/mbid&gt;
      &lt;url&gt;www.last.fm/music/Cher&lt;/url&gt;
      &lt;image_small&gt;http://userserve-ak.last.fm/serve/50/342437.jpg&lt;/image_small&gt;
      &lt;image&gt;http://userserve-ak.last.fm/serve/160/342437.jpg&lt;/image&gt;
      &lt;streamable&gt;1&lt;/streamable&gt;
    &lt;/artist&gt;
	...
  &lt;/artistmatches&gt;
&lt;/results&gt;</pre>
                                    </div>
                                
                                    <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>artist.share</h1>
    <div class="wsdescription">
        Share an artist with Last.fm users or other friends.
    </div>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">artist</span> (Required) : The artist to share.<br />
                <span class="param">recipient</span> (Required): Email Address | Last.fm Username - A comma delimited list of email addresses or Last.fm usernames. Maximum is 10.<br />
                <span class="param">message</span> (Optional): An optional message to send with the recommendation. If not supplied a default message will be used.<br />
                <span class="param">public</span> (Optional): Optionally show in the sharing users activity feed. Defaults to 0 (false).<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                  <span class="param">api_sig</span> (Required) : A Last.fm method signature. See <a href="/api/authentication">authentication</a> for more information.<br />
                     <span class="param">sk</span> (Required) : A session key generated by authenticating a user via the authentication protocol.
                              <h2>Auth</h2>
                                     
                           This service requires authentication. Please see our <a href="/api/authentication">authentication</a> how-to.<br/>
                                        This is a <b>write</b> service and must be accessed with an HTTP POST request. All parameters should be sent in the POST body, including the 'method' parameter. See <a href="/api/rest">rest requests</a> for more information.
            l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;lfm status=&quot;ok&quot;&gt;
&lt;/lfm&gt;</pre>
                                    </div>
                                
                                    <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>artist.shout</h1>
    <div class="wsdescription">
        Shout in this artist's shoutbox
    </div>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">artist</span> (Required) : The name of the artist to shout on.<br />
                <span class="param">message</span> (Required) : The message to post to the shoutbox.<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                  <span class="param">api_sig</span> (Required) : A Last.fm method signature. See <a href="/api/authentication">authentication</a> for more information.<br />
                     <span class="param">sk</span> (Required) : A session key generated by authenticating a user via the authentication protocol.
                              <h2>Auth</h2>
                                     
                           This service requires authentication. Please see our <a href="/api/authentication">authentication</a> how-to.<br/>
                                        This is a <b>write</b> service and must be accessed with an HTTP POST request. All parameters should be sent in the POST body, including the 'method' parameter. See <a href="/api/rest">rest requests</a> for more information.
            l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;lfm status=&quot;ok&quot; /&gt;</pre>
                                    </div>
                                
                                    <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>auth.getMobileSession</h1>
    <div class="wsdescription">
        Create a web service session for a user. Used for authenticating a user
when the password can be inputted by the user. Only suitable for standalone
mobile devices. See the authentication how-to for more. You must use HTTPS
and POST in order to use this method.
    </div>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">password</span> (Required) : The password in plain text.<br />
                <span class="param">username</span> (Required) : The last.fm username.<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                  <span class="param">api_sig</span> (Required) : A Last.fm method signature. See <a href="/api/authentication">authentication</a> for more information.<br />
                              <h2>Auth</h2>
                                     
                           This service does <b>not</b> require authentication.
                        l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;lfm status=&quot;ok&quot;&gt;
  &lt;session&gt;
    &lt;name&gt;MyLastFMUsername&lt;/name&gt;
    &lt;key&gt;d580d57f32848f5dcf574d1ce18d78b2&lt;/key&gt;
    &lt;subscriber&gt;0&lt;/subscriber&gt;
  &lt;/session&gt;
&lt;/lfm&gt;</pre>
                                    </div>
                                
                                    <h2>Errors</h2>
            <ul>
                                    <li><span class="param">4</span> : You must use POST in order to use this method.</li>
                                                <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>auth.getSession</h1>
    <div class="wsdescription">
        Fetch a session key for a user. The third step in the authentication
process. See the authentication how-to for more information.
    </div>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">token</span> (Required) : A 32-character ASCII hexadecimal MD5 hash returned by step 1 of the authentication process (following the granting of permissions to the application by the user)<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                  <span class="param">api_sig</span> (Required) : A Last.fm method signature. See <a href="/api/authentication">authentication</a> for more information.<br />
                              <h2>Auth</h2>
                                     
                           This service does <b>not</b> require authentication.
                        l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;lfm status=&quot;ok&quot;&gt;
  &lt;session&gt;
    &lt;name&gt;MyLastFMUsername&lt;/name&gt;
    &lt;key&gt;d580d57f32848f5dcf574d1ce18d78b2&lt;/key&gt;
     &lt;subscriber&gt;0&lt;/subscriber&gt;
  &lt;/session&gt;
&lt;/lfm&gt;</pre>
                                    </div>
                                
                                    <h2>Errors</h2>
            <ul>
                                    <li><span class="param">4</span> : Invalid authentication token supplied</li>
                                                <li><span class="param">14</span> : This token has not been authorized</li>
                                                <li><span class="param">15</span> : This token has expired</li>
                                                <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>auth.getToken</h1>
    <div class="wsdescription">
        Fetch an unathorized request token for an API account. This is step 2 of
the authentication process for desktop applications. Web applications do
not need to use this service.
    </div>
        <p class="sampleurl">
    e.g. <a href="http://ws.audioscrobbler.com/2.0/?method=auth.gettoken&api_key=b25b959554ed76058ac220b7b2e0a026">http://ws.audioscrobbler.com/2.0/?method=auth.gettoken&api_key=b25b959554ed76058ac220b7b2e0a026</a> 
    </p>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param"></span>  <br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                  <span class="param">api_sig</span> (Required) : A Last.fm method signature. See <a href="/api/authentication">authentication</a> for more information.<br />
                              <h2>Auth</h2>
                                     
                           This service does <b>not</b> require authentication.
                        l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;lfm status=&quot;ok&quot;&gt;
  &lt;token&gt;cf45fe5a3e3cebe168480a086d7fe481&lt;/token&gt;
&lt;/lfm&gt;</pre>
                                    </div>
                                
                                    <h2>Errors</h2>
            <ul>
                                    <li><span class="param">8</span> : There was an error granting the request token. Please try again later</li>
                                                <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>chart.getHypedArtists</h1>
    <div class="wsdescription">
        Get the hyped artists chart
    </div>
        <p class="sampleurl">
    e.g. <a href="http://ws.audioscrobbler.com/2.0/?method=chart.gethypedartists&api_key=b25b959554ed76058ac220b7b2e0a026">http://ws.audioscrobbler.com/2.0/?method=chart.gethypedartists&api_key=b25b959554ed76058ac220b7...</a> 
    </p>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">page</span> (Optional) : The page number to fetch.  Defaults to first page.<br />
                <span class="param">limit</span> (Optional) : The number of results to fetch per page. Defaults to 50.<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                     <h2>Auth</h2>
                                     
                           This service does <b>not</b> require authentication.
                        l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;artists page=&quot;1&quot; perPage=&quot;50&quot; totalPages=&quot;10&quot; total=&quot;500&quot;&gt;
  &lt;artist&gt;
    &lt;name&gt;Sean Bones&lt;/name&gt;
    &lt;percentagechange&gt;1142&lt;/percentagechange&gt;
    &lt;mbid/&gt;
    &lt;url&gt;http://www.last.fm/music/Sean+Bones&lt;/url&gt;
    &lt;streamable&gt;0&lt;/streamable&gt;
    &lt;image size=&quot;small&quot;&gt;http://userserve-ak.last.fm/serve/34/34727499.jpg&lt;/image&gt;
    &lt;image size=&quot;medium&quot;&gt;http://userserve-ak.last.fm/serve/64/34727499.jpg&lt;/image&gt;
    &lt;image size=&quot;large&quot;&gt;http://userserve-ak.last.fm/serve/126/34727499.jpg&lt;/image&gt;
    &lt;image size=&quot;extralarge&quot;&gt;http://userserve-ak.last.fm/serve/252/34727499.jpg&lt;/image&gt;
    &lt;image size=&quot;mega&quot;&gt;http://userserve-ak.last.fm/serve/_/34727499/Sean+Bones.jpg&lt;/image&gt;
  &lt;/artist&gt;
  ...
&lt;/artists&gt;</pre>
                                    </div>
                                
                                    <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>chart.getHypedTracks</h1>
    <div class="wsdescription">
        Get the top artists chart
    </div>
        <p class="sampleurl">
    e.g. <a href="http://ws.audioscrobbler.com/2.0/?method=chart.gethypedtracks&api_key=b25b959554ed76058ac220b7b2e0a026">http://ws.audioscrobbler.com/2.0/?method=chart.gethypedtracks&api_key=b25b959554ed76058ac220b7b...</a> 
    </p>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">page</span> (Optional) : The page number to fetch.  Defaults to first page.<br />
                <span class="param">limit</span> (Optional) : The number of results to fetch per page. Defaults to 50.<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                     <h2>Auth</h2>
                                     
                           This service does <b>not</b> require authentication.
                        l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;tracks page=&quot;1&quot; perPage=&quot;50&quot; totalPages=&quot;10&quot; total=&quot;500&quot;&gt;
  &lt;track&gt;
    &lt;name&gt;The Time (Dirty Bit)&lt;/name&gt;
    &lt;percentagechange&gt;8285&lt;/percentagechange&gt;
    &lt;mbid/&gt;
    &lt;url&gt;http://www.last.fm/music/Black+Eyed+Peas/_/The+Time+%28Dirty+Bit%29&lt;/url&gt;
    &lt;streamable fulltrack=&quot;0&quot;&gt;0&lt;/streamable&gt;
    &lt;artist&gt;
      &lt;name&gt;Black Eyed Peas&lt;/name&gt;
      &lt;mbid&gt;d5be5333-4171-427e-8e12-732087c6b78e&lt;/mbid&gt;
      &lt;url&gt;http://www.last.fm/music/Black+Eyed+Peas&lt;/url&gt;
    &lt;/artist&gt;
    &lt;image size=&quot;small&quot;&gt;http://userserve-ak.last.fm/serve/34s/54717857.png&lt;/image&gt;
    &lt;image size=&quot;medium&quot;&gt;http://userserve-ak.last.fm/serve/64s/54717857.png&lt;/image&gt;
    &lt;image size=&quot;large&quot;&gt;http://userserve-ak.last.fm/serve/126/54717857.png&lt;/image&gt;
    &lt;image size=&quot;extralarge&quot;&gt;http://userserve-ak.last.fm/serve/300x300/54717857.png&lt;/image&gt;
  &lt;/track&gt;
  ...
&lt;/tracks&gt;</pre>
                                    </div>
                                
                                    <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>chart.getLovedTracks</h1>
    <div class="wsdescription">
        Get the most loved tracks chart
    </div>
        <p class="sampleurl">
    e.g. <a href="http://ws.audioscrobbler.com/2.0/?method=chart.getlovedtracks&api_key=b25b959554ed76058ac220b7b2e0a026">http://ws.audioscrobbler.com/2.0/?method=chart.getlovedtracks&api_key=b25b959554ed76058ac220b7b...</a> 
    </p>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">page</span> (Optional) : The page number to fetch.  Defaults to first page.<br />
                <span class="param">limit</span> (Optional) : The number of results to fetch per page. Defaults to 50.<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                     <h2>Auth</h2>
                                     
                           This service does <b>not</b> require authentication.
                        l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;tracks page=&quot;1&quot; perPage=&quot;50&quot; totalPages=&quot;10&quot; total=&quot;500&quot;&gt;
  &lt;track&gt;
    &lt;name&gt;Lollipop&lt;/name&gt;
    &lt;loves&gt;3249&lt;/loves&gt;
    &lt;mbid/&gt;
    &lt;url&gt;http://www.last.fm/music/Lil%27+Wayne/_/Lollipop&lt;/url&gt;
    &lt;streamable fulltrack=&quot;0&quot;&gt;0&lt;/streamable&gt;
    &lt;artist&gt;
      &lt;name&gt;Lil' Wayne&lt;/name&gt;
      &lt;mbid&gt;ac9a487a-d9d2-4f27-bb23-0f4686488345&lt;/mbid&gt;
      &lt;url&gt;http://www.last.fm/music/Lil%27+Wayne&lt;/url&gt;
    &lt;/artist&gt;
    &lt;image size=&quot;small&quot;&gt;http://userserve-ak.last.fm/serve/34s/53142375.png&lt;/image&gt;
    &lt;image size=&quot;medium&quot;&gt;http://userserve-ak.last.fm/serve/64s/53142375.png&lt;/image&gt;
    &lt;image size=&quot;large&quot;&gt;http://userserve-ak.last.fm/serve/126/53142375.png&lt;/image&gt;
    &lt;image size=&quot;extralarge&quot;&gt;http://userserve-ak.last.fm/serve/300x300/53142375.png&lt;/image&gt;
  &lt;/track&gt;
  ...
&lt;/tracks&gt;</pre>
                                    </div>
                                
                                    <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>chart.getTopArtists</h1>
    <div class="wsdescription">
        Get the top artists chart
    </div>
        <p class="sampleurl">
    e.g. <a href="http://ws.audioscrobbler.com/2.0/?method=chart.gettopartists&api_key=b25b959554ed76058ac220b7b2e0a026">http://ws.audioscrobbler.com/2.0/?method=chart.gettopartists&api_key=b25b959554ed76058ac220b7b2...</a> 
    </p>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">page</span> (Optional) : The page number to fetch.  Defaults to first page.<br />
                <span class="param">limit</span> (Optional) : The number of results to fetch per page. Defaults to 50.<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                     <h2>Auth</h2>
                                     
                           This service does <b>not</b> require authentication.
                        l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;artists page=&quot;1&quot; perPage=&quot;50&quot; totalPages=&quot;20&quot; total=&quot;1000&quot;&gt;
  &lt;artist&gt;
    &lt;name&gt;The Beatles&lt;/name&gt;
    &lt;playcount&gt;1550293&lt;/playcount&gt;
    &lt;listeners&gt;114106&lt;/listeners&gt;
    &lt;mbid&gt;b10bbbfc-cf9e-42e0-be17-e2c3e1d2600d&lt;/mbid&gt;
    &lt;url&gt;http://www.last.fm/music/The+Beatles&lt;/url&gt;
    &lt;streamable&gt;1&lt;/streamable&gt;
    &lt;image size=&quot;small&quot;&gt;http://userserve-ak.last.fm/serve/34/880929.jpg&lt;/image&gt;
    &lt;image size=&quot;medium&quot;&gt;http://userserve-ak.last.fm/serve/64/880929.jpg&lt;/image&gt;
    &lt;image size=&quot;large&quot;&gt;http://userserve-ak.last.fm/serve/126/880929.jpg&lt;/image&gt;
    &lt;image size=&quot;extralarge&quot;&gt;http://userserve-ak.last.fm/serve/252/880929.jpg&lt;/image&gt;
    &lt;image size=&quot;mega&quot;&gt;http://userserve-ak.last.fm/serve/500/880929/The+Beatles.jpg&lt;/image&gt;
  &lt;/artist&gt;
  ...
&lt;/artists&gt;</pre>
                                    </div>
                                
                                    <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>chart.getTopTags</h1>
    <div class="wsdescription">
        Get the top artists chart
    </div>
        <p class="sampleurl">
    e.g. <a href="http://ws.audioscrobbler.com/2.0/?method=chart.gettoptags&api_key=b25b959554ed76058ac220b7b2e0a026">http://ws.audioscrobbler.com/2.0/?method=chart.gettoptags&api_key=b25b959554ed76058ac220b7b2e0a026</a> 
    </p>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">page</span> (Optional) : The page number to fetch.  Defaults to first page.<br />
                <span class="param">limit</span> (Optional) : The number of results to fetch per page. Defaults to 50.<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                     <h2>Auth</h2>
                                     
                           This service does <b>not</b> require authentication.
                        l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;tags page=&quot;1&quot; perPage=&quot;50&quot; totalPages=&quot;5&quot; total=&quot;250&quot;&gt;
  &lt;tag&gt;
    &lt;name&gt;rock&lt;/name&gt;
    &lt;url&gt;http://www.last.fm/tag/rock&lt;/url&gt;
    &lt;reach&gt;309437&lt;/reach&gt;
    &lt;taggings&gt;3064604&lt;/taggings&gt;
    &lt;streamable&gt;1&lt;/streamable&gt;
    &lt;wiki&gt;
      &lt;published&gt;Sun, 24 Oct 2010 17:40:33 +0000&lt;/published&gt;
      &lt;summary&gt;
Rock music is a genre of music started in America. It h...
      &lt;/summary&gt;
      &lt;content&gt;
Rock music is a genre of music started in America. It has its roots in 1940s and 1950s rock and roll and rockabilly, which evolved from blues, country music and other influences. According to the All Music Guide, “In its pu...
      &lt;/content&gt;
    &lt;/wiki&gt;
&lt;/tag&gt;
...
&lt;/tags&gt;</pre>
                                    </div>
                                
                                    <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>chart.getTopTracks</h1>
    <div class="wsdescription">
        Get the top tracks chart
    </div>
        <p class="sampleurl">
    e.g. <a href="http://ws.audioscrobbler.com/2.0/?method=chart.gettoptracks&api_key=b25b959554ed76058ac220b7b2e0a026">http://ws.audioscrobbler.com/2.0/?method=chart.gettoptracks&api_key=b25b959554ed76058ac220b7b2e...</a> 
    </p>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">page</span> (Optional) : The page number to fetch.  Defaults to first page.<br />
                <span class="param">limit</span> (Optional) : The number of results to fetch per page. Defaults to 50.<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                     <h2>Auth</h2>
                                     
                           This service does <b>not</b> require authentication.
                        l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;tracks page=&quot;1&quot; perPage=&quot;50&quot; totalPages=&quot;20&quot; total=&quot;1000&quot;&gt;
  &lt;track&gt;
    &lt;name&gt;Dark Fantasy&lt;/name&gt;
    &lt;playcount&gt;124394&lt;/playcount&gt;
    &lt;listeners&gt;42141&lt;/listeners&gt;
    &lt;mbid/&gt;
    &lt;url&gt;http://www.last.fm/music/Kanye+West/_/Dark+Fantasy&lt;/url&gt;
    &lt;streamable fulltrack=&quot;0&quot;&gt;0&lt;/streamable&gt;
    &lt;artist&gt;
      &lt;name&gt;Kanye West&lt;/name&gt;
      &lt;mbid&gt;164f0d73-1234-4e2c-8743-d77bf2191051&lt;/mbid&gt;
      &lt;url&gt;http://www.last.fm/music/Kanye+West&lt;/url&gt;
    &lt;/artist&gt;
  &lt;/track&gt;
  ...
&lt;/tracks&gt;</pre>
                                    </div>
                                
                                    <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>event.attend</h1>
    <div class="wsdescription">
        Set a user's attendance status for an event.
    </div>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">event</span> (Required) : The numeric last.fm event id<br />
                <span class="param">status</span> (Required) : The attendance status (0=Attending, 1=Maybe attending, 2=Not attending)<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                  <span class="param">api_sig</span> (Required) : A Last.fm method signature. See <a href="/api/authentication">authentication</a> for more information.<br />
                     <span class="param">sk</span> (Required) : A session key generated by authenticating a user via the authentication protocol.
                              <h2>Auth</h2>
                                     
                           This service requires authentication. Please see our <a href="/api/authentication">authentication</a> how-to.<br/>
                                        This is a <b>write</b> service and must be accessed with an HTTP POST request. All parameters should be sent in the POST body, including the 'method' parameter. See <a href="/api/rest">rest requests</a> for more information.
            l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;lfm status=&quot;ok&quot;&gt;
&lt;/lfm&gt;</pre>
                                    </div>
                                
                                    <h2>Errors</h2>
            <ul>
                                    <li><span class="param">6</span> : Invalid artist name supplied</li>
                                                <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>event.getAttendees</h1>
    <div class="wsdescription">
        Get a list of attendees for an event.
    </div>
        <p class="sampleurl">
    e.g. <a href="http://ws.audioscrobbler.com/2.0/?method=event.getattendees&event=328799&api_key=b25b959554ed76058ac220b7b2e0a026">http://ws.audioscrobbler.com/2.0/?method=event.getattendees&event=328799&api_key=b25b959554ed76...</a> 
    </p>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">event</span> (Required) : The numeric last.fm event id<br />
                <span class="param">page</span> (Optiona) : The page number to fetch.  Defaults to first page.<br />
                <span class="param">limit</span> (Optional) : The number of results to fetch per page. Defaults to 50.<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                     <h2>Auth</h2>
                                     
                           This service does <b>not</b> require authentication.
                        l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;attendees event=&quot;328799&quot; total=&quot;41&quot;&gt;
  &lt;user&gt;
    &lt;name&gt;ikea&lt;/name&gt;
    &lt;realname&gt;Jane&lt;/realname&gt;
    &lt;image size=&quot;small&quot;&gt;http://userserve-ak.last.fm/serve/34/17805805.jpg&lt;/image&gt;
    &lt;image size=&quot;medium&quot;&gt;http://userserve-ak.last.fm/serve/64/17805805.jpg&lt;/image&gt;
    &lt;image size=&quot;large&quot;&gt;http://userserve-ak.last.fm/serve/126/17805805.jpg&lt;/image&gt;
    &lt;url&gt;http://www.last.fm/user/ikea&lt;/url&gt;
  &lt;/user&gt;
  ...
&lt;/attendees&gt;</pre>
                                    </div>
                                
                                    <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>event.getInfo</h1>
    <div class="wsdescription">
        Get the metadata for an event on Last.fm. Includes attendance and lineup
information.
    </div>
        <p class="sampleurl">
    e.g. <a href="http://ws.audioscrobbler.com/2.0/?method=event.getinfo&event=328799&api_key=b25b959554ed76058ac220b7b2e0a026">http://ws.audioscrobbler.com/2.0/?method=event.getinfo&event=328799&api_key=b25b959554ed76058ac...</a> 
    </p>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">event</span> (Required) : The numeric last.fm event id<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                     <h2>Auth</h2>
                                     
                           This service does <b>not</b> require authentication.
                        l
            <h2>Sample Response</h2>
                                                                                                                                                                                                                                            <div id="sample">
                    <pre>&lt;lfm status=&quot;ok&quot;&gt; 
&lt;event xmlns:geo=&quot;http://www.w3.org/2003/01/geo/wgs84_pos#&quot; &gt; 
  &lt;id&gt;1073657&lt;/id&gt; 
  &lt;title&gt;Neko Case&lt;/title&gt; 
  &lt;artists&gt; 
    &lt;artist&gt;Neko Case&lt;/artist&gt; 
    &lt;headliner&gt;Neko Case&lt;/headliner&gt; 
  &lt;/artists&gt; 
  &lt;venue&gt; 
    &lt;id&gt;8783057&lt;/id&gt; 
    &lt;name&gt;Ryman Auditorium&lt;/name&gt; 
    &lt;location&gt; 
      &lt;city&gt;Nashville&lt;/city&gt; 
      &lt;country&gt;United States&lt;/country&gt; 
      &lt;street&gt;116 Fifth Avenue North&lt;/street&gt; 
      &lt;postalcode&gt;37219&lt;/postalcode&gt; 
      &lt;geo:point&gt; 
         &lt;geo:lat&gt;36.16148&lt;/geo:lat&gt; 
         &lt;geo:long&gt;-86.777959&lt;/geo:long&gt; 
      &lt;/geo:point&gt; 
    &lt;/location&gt; 
    &lt;url&gt;http://www.last.fm/venue/8783057&lt;/url&gt; 
  &lt;/venue&gt; 
  &lt;startDate&gt;Sat, 25 Jul 2009 20:00:00&lt;/startDate&gt; 
  &lt;description&gt;&lt;/description&gt; 
  &lt;image size=&quot;small&quot;&gt;http://userserve-ak.last.fm/serve/34/17278547.jpg&lt;/image&gt; 
  &lt;image size=&quot;medium&quot;&gt;http://userserve-ak.last.fm/serve/64/17278547.jpg&lt;/image&gt; 
  &lt;image size=&quot;large&quot;&gt;http://userserve-ak.last.fm/serve/126/17278547.jpg&lt;/image&gt; 
  &lt;attendance&gt;2&lt;/attendance&gt; 
  &lt;reviews&gt;0&lt;/reviews&gt; 
  &lt;<span class="tagDescription" title="Use this machine tag to find photos of this event on flickr">tag</span>&gt;lastfm:event=1073657&lt;/tag&gt; 
  &lt;url&gt;http://www.last.fm/event/1073657&lt;/url&gt; 
  &lt;website&gt;http://www.ryman.com/&lt;/website&gt; 
  &lt;tickets&gt; 
    &lt;ticket supplier=&quot;TicketMaster&quot;&gt;http://www.last.fm/affiliate_redirect.php?restype=29&amp;amp;id=1073657&amp;amp;supplier=12&lt;/ticket&gt; 
  &lt;/tickets&gt;  
&lt;/event&gt;&lt;/lfm&gt;</pre>
                                        Hover over the underlined tags and attributes to get detailed information.
                                    </div>
                                
                    <h2>Other Formats</h2>
                            Also available as a feed in <b>ical</b> format                <p>
                                    e.g. <a href="http://ws.audioscrobbler.com/2.0/event/328799/info.ical">http://ws.audioscrobbler.com/2.0/event/328799/info.ical</a><br />
                                </p>
                                                <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>event.getShouts</h1>
    <div class="wsdescription">
        Get shouts for this event. Also available as an rss feed.
    </div>
        <p class="sampleurl">
    e.g. <a href="http://ws.audioscrobbler.com/2.0/?method=event.getshouts&event=328799&api_key=b25b959554ed76058ac220b7b2e0a026">http://ws.audioscrobbler.com/2.0/?method=event.getshouts&event=328799&api_key=b25b959554ed76058...</a> 
    </p>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">event</span> (Required) : The numeric last.fm event id<br />
                <span class="param">page</span> (Optional) : The page number to fetch.  Defaults to first page.<br />
                <span class="param">limit</span> (Optional) : The number of results to fetch per page. Defaults to 50.<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                     <h2>Auth</h2>
                                     
                           This service does <b>not</b> require authentication.
                        l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;shouts event=&quot;328799&quot; total=&quot;5&quot;&gt;
  &lt;shout&gt;
    &lt;body&gt;Blah&lt;/body&gt;
    &lt;author&gt;joanofarctan&lt;/author&gt;
    &lt;date&gt;Fri, 12 Dec 2008 13:20:41&lt;/date&gt;
  &lt;/shout&gt;
  ...
&lt;/shouts&gt;</pre>
                                    </div>
                                
                    <h2>Other Formats</h2>
                            Also available as a feed in <b>rss</b> format                <p>
                                    e.g. <a href="http://ws.audioscrobbler.com/2.0/event/328799/shouts.rss">http://ws.audioscrobbler.com/2.0/event/328799/shouts.rss</a><br />
                                </p>
                                                <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>event.share</h1>
    <div class="wsdescription">
        Share an event with one or more Last.fm users or other friends.
    </div>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">event</span> (Required) : An event ID<br />
                <span class="param">public</span> (Optional): Optionally show the share in the sharing users recent activity. Defaults to 0 (false).<br />
                <span class="param">message</span> (Optional): An optional message to send with the recommendation. If not supplied a default message will be used.<br />
                <span class="param">recipient</span> (Required): Email Address | Last.fm Username - A comma delimited list of email addresses or Last.fm usernames. Maximum is 10.<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                  <span class="param">api_sig</span> (Required) : A Last.fm method signature. See <a href="/api/authentication">authentication</a> for more information.<br />
                     <span class="param">sk</span> (Required) : A session key generated by authenticating a user via the authentication protocol.
                              <h2>Auth</h2>
                                     
                           This service requires authentication. Please see our <a href="/api/authentication">authentication</a> how-to.<br/>
                                        This is a <b>write</b> service and must be accessed with an HTTP POST request. All parameters should be sent in the POST body, including the 'method' parameter. See <a href="/api/rest">rest requests</a> for more information.
            l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;lfm status=&quot;ok&quot;&gt;
&lt;/lfm&gt;</pre>
                                    </div>
                                
                                    <h2>Errors</h2>
            <ul>
                                    <li><span class="param">6</span> : Invalid track name supplied</li>
                                                <li><span class="param">8</span> : Operation Failed - Server Error. Please try again later.</li>
                                                <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>event.shout</h1>
    <div class="wsdescription">
        Shout in this event's shoutbox
    </div>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">event</span> (Required) : The id of the event to shout on<br />
                <span class="param">message</span> (Required) : The message to post to the shoutbox<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                  <span class="param">api_sig</span> (Required) : A Last.fm method signature. See <a href="/api/authentication">authentication</a> for more information.<br />
                     <span class="param">sk</span> (Required) : A session key generated by authenticating a user via the authentication protocol.
                              <h2>Auth</h2>
                                     
                           This service requires authentication. Please see our <a href="/api/authentication">authentication</a> how-to.<br/>
                                        This is a <b>write</b> service and must be accessed with an HTTP POST request. All parameters should be sent in the POST body, including the 'method' parameter. See <a href="/api/rest">rest requests</a> for more information.
            l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;lfm status=&quot;ok&quot; /&gt;</pre>
                                    </div>
                                
                                    <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>geo.getEvents</h1>
    <div class="wsdescription">
        Get all events in a specific location by country or city name.
    </div>
        <p class="sampleurl">
    e.g. <a href="http://ws.audioscrobbler.com/2.0/?method=geo.getevents&location=madrid&api_key=b25b959554ed76058ac220b7b2e0a026">http://ws.audioscrobbler.com/2.0/?method=geo.getevents&location=madrid&api_key=b25b959554ed7605...</a> 
    </p>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">long</span> (Optional) : Specifies a longitude value to retrieve events for (service returns nearby events by default)<br />
                <span class="param">lat</span> (Optional) : Specifies a latitude value to retrieve events for (service returns nearby events by default)<br />
                <span class="param">location</span> (Optional) : Specifies a location to retrieve events for (service returns nearby events by default)<br />
                <span class="param">distance</span> (Optional) : Find events within a specified radius (in kilometres)<br />
                <span class="param">page</span> (Optional) : The page number to fetch.  Defaults to first page.<br />
                <span class="param">tag</span> (Optional) : Specifies a tag to filter by.<br />
                <span class="param">festivalsonly[0|1]</span> (Optional) : Whether only festivals should be returned, or all events.<br />
                <span class="param">limit</span> (Optional) : The number of results to fetch per page. Defaults to 10.<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                     <h2>Auth</h2>
                                     
                           This service does <b>not</b> require authentication.
                        l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;events location=&quot;New York&quot; page=&quot;1&quot; totalpages=&quot;105&quot; total=&quot;1050&quot;&gt;
&lt;event&gt;
  &lt;id&gt;640418&lt;/id&gt;
  &lt;title&gt;Nikka Costa&lt;/title&gt;
  &lt;artists&gt;
    &lt;artist&gt;Nikka Costa&lt;/artist&gt;
    &lt;headliner&gt;Nikka Costa&lt;/headliner&gt;
  &lt;/artists&gt;
  &lt;venue&gt;
    &lt;name&gt;Bowery Ballroom&lt;/name&gt;
    &lt;location&gt;
      &lt;city&gt;New York&lt;/city&gt;
      &lt;country&gt;United States&lt;/country&gt;
      &lt;street&gt;6 Delancey&lt;/street&gt;
      &lt;postalcode&gt;10002&lt;/postalcode&gt;
      &lt;geo:point&gt;
         &lt;geo:lat&gt;40.71417&lt;/geo:lat&gt;
         &lt;geo:long&gt;-74.00639&lt;/geo:long&gt;
      &lt;/geo:point&gt;
      &lt;timezone&gt;EST&lt;/timezone&gt;
    &lt;/location&gt;
    &lt;url&gt;http://www.last.fm/venue/8779095&lt;/url&gt;
  &lt;/venue&gt;
  &lt;startDate&gt;Mon, 30 Jun 2008&lt;/startDate&gt;
  &lt;startTime&gt;20:00&lt;/startTime&gt;
  &lt;description&gt;&lt;![CDATA[Doors 8pm&lt;br /&gt;
$20&lt;br /&gt;
18+]]&gt;&lt;/description&gt;
  &lt;image size=&quot;small&quot;&gt;...&lt;/image&gt;
  &lt;image size=&quot;medium&quot;&gt;...&lt;/image&gt;
  &lt;image size=&quot;large&quot;&gt;...&lt;/image&gt;
  &lt;attendance&gt;42&lt;/attendance&gt;
  &lt;reviews&gt;0&lt;/reviews&gt;
  &lt;tag&gt;lastfm:event=640418&lt;/&lt;/tag&gt;
  &lt;url&gt;http://www.last.fm/event/640418&lt;/url&gt;
  &lt;website&gt;http://...&lt;/website&gt;
  &lt;tickets&gt;
    &lt;ticket supplier=&quot;...&quot;&gt;http://...&lt;/ticket&gt;
    ...
  &lt;/tickets&gt;
&lt;/event&gt;
...
&lt;/events&gt;</pre>
                                    </div>
                                
                    <h2>Other Formats</h2>
                            Also available as a feed in <b>rss,ical</b> formats                <p>
                                    e.g. <a href="http://ws.audioscrobbler.com/2.0/geo/spain/events.rss">http://ws.audioscrobbler.com/2.0/geo/spain/events.rss</a><br />
                                    e.g. <a href="http://ws.audioscrobbler.com/2.0/geo/spain/events.ical">http://ws.audioscrobbler.com/2.0/geo/spain/events.ical</a><br />
                                </p>
                                                <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>geo.getMetroArtistChart</h1>
    <div class="wsdescription">
        Get a chart of artists for a metro
    </div>
        <p class="sampleurl">
    e.g. <a href="http://ws.audioscrobbler.com/2.0/?method=geo.getmetroartistchart&country=spain&metro=madrid&api_key=b25b959554ed76058ac220b7b2e0a026">http://ws.audioscrobbler.com/2.0/?method=geo.getmetroartistchart&country=spain&metro=madrid&api...</a> 
    </p>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">metro</span> (Required) : The metro's name<br />
                <span class="param">country</span> (Required) : A country name, as defined by the ISO 3166-1 country names standard<br />
                <span class="param">start</span> (Optional) : Beginning timestamp of the weekly range requested (c.f. geo.getWeeklyChartlist)<br />
                <span class="param">end</span> (Optional) : Ending timestamp of the weekly range requested (c.f. geo.getWeeklyChartlist)<br />
                <span class="param">page</span> (Optional) : The page number to fetch.  Defaults to first page.<br />
                <span class="param">limit</span> (Optional) : The number of results to fetch per page. Defaults to 50.<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                     <h2>Auth</h2>
                                     
                           This service does <b>not</b> require authentication.
                        l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;?xml version=&quot;1.0&quot; encoding=&quot;utf-8&quot;?&gt;
&lt;lfm status=&quot;ok&quot;&gt;
    &lt;topartists metro=&quot;Madrid&quot; &gt;
        &lt;artist rank=&quot;1&quot;&gt;
            &lt;name&gt;Muse&lt;/name&gt;
            &lt;playcount&gt;&lt;/playcount&gt;
            &lt;mbid&gt;9c9f1380-2516-4fc9-a3e6-f9f61941d090&lt;/mbid&gt;
            &lt;url&gt;http://www.last.fm/music/Muse&lt;/url&gt;
            &lt;streamable&gt;1&lt;/streamable&gt;
            &lt;image size=&quot;small&quot;&gt;http://userserve-ak.last.fm/serve/34/364188.jpg&lt;/image&gt;
            &lt;image size=&quot;medium&quot;&gt;http://userserve-ak.last.fm/serve/64/364188.jpg&lt;/image&gt;
            &lt;image size=&quot;large&quot;&gt;http://userserve-ak.last.fm/serve/126/364188.jpg&lt;/image&gt;
            &lt;image size=&quot;extralarge&quot;&gt;http://userserve-ak.last.fm/serve/252/364188.jpg&lt;/image&gt;
            &lt;image size=&quot;mega&quot;&gt;&lt;/image&gt;
        &lt;/artist&gt;
        &lt;artist rank=&quot;2&quot;&gt;
            &lt;name&gt;The Killers&lt;/name&gt;
            &lt;playcount&gt;&lt;/playcount&gt;
            &lt;mbid&gt;95e1ead9-4d31-4808-a7ac-32c3614c116b&lt;/mbid&gt;
            &lt;url&gt;http://www.last.fm/music/The+Killers&lt;/url&gt;
            &lt;streamable&gt;1&lt;/streamable&gt;
            &lt;image size=&quot;small&quot;&gt;http://userserve-ak.last.fm/serve/34/95070.jpg&lt;/image&gt;
            &lt;image size=&quot;medium&quot;&gt;http://userserve-ak.last.fm/serve/64/95070.jpg&lt;/image&gt;
            &lt;image size=&quot;large&quot;&gt;http://userserve-ak.last.fm/serve/126/95070.jpg&lt;/image&gt;
            &lt;image size=&quot;extralarge&quot;&gt;http://userserve-ak.last.fm/serve/252/95070.jpg&lt;/image&gt;
            &lt;image size=&quot;mega&quot;&gt;&lt;/image&gt;
        &lt;/artist&gt;
        ...
    &lt;/topartists&gt;
&lt;/lfm&gt;</pre>
                                    </div>
                                
                    <h2>Other Formats</h2>
                            Also available as a feed in <b>rss</b> format                <p>
                                    e.g. <a href="http://ws.audioscrobbler.com/2.0/geo/spain/metroartistchart.rss?metro=madrid">http://ws.audioscrobbler.com/2.0/geo/spain/metroartistchart.rss?metro=madrid</a><br />
                                </p>
                                                <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>geo.getMetroHypeArtistChart</h1>
    <div class="wsdescription">
        Get a chart of hyped (up and coming) artists for a metro
    </div>
        <p class="sampleurl">
    e.g. <a href="http://ws.audioscrobbler.com/2.0/?method=geo.getmetrohypeartistchart&country=spain&metro=madrid&api_key=b25b959554ed76058ac220b7b2e0a026">http://ws.audioscrobbler.com/2.0/?method=geo.getmetrohypeartistchart&country=spain&metro=madrid...</a> 
    </p>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">metro</span> (Required) : The metro's name<br />
                <span class="param">country</span> (Required) : A country name, as defined by the ISO 3166-1 country names standard<br />
                <span class="param">start</span> (Optional) : Beginning timestamp of the weekly range requested (c.f. geo.getWeeklyChartlist)<br />
                <span class="param">end</span> (Optional) : Ending timestamp of the weekly range requested (c.f. geo.getWeeklyChartlist)<br />
                <span class="param">page</span> (Optional) : The page number to fetch.  Defaults to first page.<br />
                <span class="param">limit</span> (Optional) : The number of results to fetch per page. Defaults to 50.<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                     <h2>Auth</h2>
                                     
                           This service does <b>not</b> require authentication.
                        l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;?xml version=&quot;1.0&quot; encoding=&quot;utf-8&quot;?&gt;
&lt;lfm status=&quot;ok&quot;&gt;
    &lt;topartists metro=&quot;Madrid&quot; &gt;
        &lt;artist rank=&quot;1&quot;&gt;
            &lt;name&gt;Muse&lt;/name&gt;
            &lt;playcount&gt;&lt;/playcount&gt;
            &lt;mbid&gt;9c9f1380-2516-4fc9-a3e6-f9f61941d090&lt;/mbid&gt;
            &lt;url&gt;http://www.last.fm/music/Muse&lt;/url&gt;
            &lt;streamable&gt;1&lt;/streamable&gt;
            &lt;image size=&quot;small&quot;&gt;http://userserve-ak.last.fm/serve/34/364188.jpg&lt;/image&gt;
            &lt;image size=&quot;medium&quot;&gt;http://userserve-ak.last.fm/serve/64/364188.jpg&lt;/image&gt;
            &lt;image size=&quot;large&quot;&gt;http://userserve-ak.last.fm/serve/126/364188.jpg&lt;/image&gt;
            &lt;image size=&quot;extralarge&quot;&gt;http://userserve-ak.last.fm/serve/252/364188.jpg&lt;/image&gt;
            &lt;image size=&quot;mega&quot;&gt;&lt;/image&gt;
        &lt;/artist&gt;
        &lt;artist rank=&quot;2&quot;&gt;
            &lt;name&gt;The Killers&lt;/name&gt;
            &lt;playcount&gt;&lt;/playcount&gt;
            &lt;mbid&gt;95e1ead9-4d31-4808-a7ac-32c3614c116b&lt;/mbid&gt;
            &lt;url&gt;http://www.last.fm/music/The+Killers&lt;/url&gt;
            &lt;streamable&gt;1&lt;/streamable&gt;
            &lt;image size=&quot;small&quot;&gt;http://userserve-ak.last.fm/serve/34/95070.jpg&lt;/image&gt;
            &lt;image size=&quot;medium&quot;&gt;http://userserve-ak.last.fm/serve/64/95070.jpg&lt;/image&gt;
            &lt;image size=&quot;large&quot;&gt;http://userserve-ak.last.fm/serve/126/95070.jpg&lt;/image&gt;
            &lt;image size=&quot;extralarge&quot;&gt;http://userserve-ak.last.fm/serve/252/95070.jpg&lt;/image&gt;
            &lt;image size=&quot;mega&quot;&gt;&lt;/image&gt;
        &lt;/artist&gt;
        ...
    &lt;/topartists&gt;
&lt;/lfm&gt;</pre>
                                    </div>
                                
                    <h2>Other Formats</h2>
                            Also available as a feed in <b>rss</b> format                <p>
                                    e.g. <a href="http://ws.audioscrobbler.com/2.0/geo/spain/metrohypeartistchart.rss?metro=madrid">http://ws.audioscrobbler.com/2.0/geo/spain/metrohypeartistchart.rss?metro=madrid</a><br />
                                </p>
                                                <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>geo.getMetroHypeTrackChart</h1>
    <div class="wsdescription">
        Get a chart of tracks for a metro
    </div>
        <p class="sampleurl">
    e.g. <a href="http://ws.audioscrobbler.com/2.0/?method=geo.getmetrohypetrackchart&country=spain&metro=madrid&api_key=b25b959554ed76058ac220b7b2e0a026">http://ws.audioscrobbler.com/2.0/?method=geo.getmetrohypetrackchart&country=spain&metro=madrid&...</a> 
    </p>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">metro</span> (Required) : The metro's name<br />
                <span class="param">country</span> (Required) : A country name, as defined by the ISO 3166-1 country names standard<br />
                <span class="param">start</span> (Optional) : Beginning timestamp of the weekly range requested (c.f. geo.getWeeklyChartlist)<br />
                <span class="param">end</span> (Optional) : Ending timestamp of the weekly range requested (c.f. geo.getWeeklyChartlist)<br />
                <span class="param">page</span> (Optional) : The page number to fetch.  Defaults to first page.<br />
                <span class="param">limit</span> (Optional) : The number of results to fetch per page. Defaults to 50.<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                     <h2>Auth</h2>
                                     
                           This service does <b>not</b> require authentication.
                        l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;?xml version=&quot;1.0&quot; encoding=&quot;utf-8&quot;?&gt;
&lt;lfm status=&quot;ok&quot;&gt;
    &lt;toptracks metro=&quot;Madrid&quot;&gt;
        &lt;track rank=&quot;1&quot;&gt;
            &lt;name&gt;Valiente&lt;/name&gt;
            &lt;playcount&gt;&lt;/playcount&gt;
            &lt;mbid&gt;&lt;/mbid&gt;
            &lt;url&gt;http://www.last.fm/music/Vetusta+Morla/_/Valiente&lt;/url&gt;
            &lt;streamable fulltrack=&quot;0&quot;&gt;0&lt;/streamable&gt;
            &lt;artist&gt;
                &lt;name&gt;Vetusta Morla&lt;/name&gt;
                &lt;mbid&gt;&lt;/mbid&gt;
                &lt;url&gt;http://www.last.fm/music/Vetusta+Morla&lt;/url&gt;
            &lt;/artist&gt;
        &lt;/track&gt;
        &lt;track rank=&quot;2&quot;&gt;
            &lt;name&gt;Copenhage&lt;/name&gt;
            &lt;playcount&gt;&lt;/playcount&gt;
            &lt;mbid&gt;&lt;/mbid&gt;
            &lt;url&gt;http://www.last.fm/music/+noredirect/Vetusta+Morla/_/Copenhage&lt;/url&gt;
            &lt;streamable fulltrack=&quot;0&quot;&gt;0&lt;/streamable&gt;
            &lt;artist&gt;
                &lt;name&gt;Vetusta Morla&lt;/name&gt;
                &lt;mbid&gt;&lt;/mbid&gt;
                &lt;url&gt;http://www.last.fm/music/Vetusta+Morla&lt;/url&gt;
            &lt;/artist&gt;
        &lt;/track&gt;
    &lt;/toptracks&gt;
    ...
&lt;/lfm&gt;</pre>
                                    </div>
                                
                    <h2>Other Formats</h2>
                            Also available as a feed in <b>rss</b> format                <p>
                                    e.g. <a href="http://ws.audioscrobbler.com/2.0/geo/spain/metrohypetrackchart.rss?metro=madrid">http://ws.audioscrobbler.com/2.0/geo/spain/metrohypetrackchart.rss?metro=madrid</a><br />
                                </p>
                                                <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>geo.getMetroTrackChart</h1>
    <div class="wsdescription">
        Get a chart of tracks for a metro
    </div>
        <p class="sampleurl">
    e.g. <a href="http://ws.audioscrobbler.com/2.0/?method=geo.getmetrotrackchart&country=spain&metro=madrid&api_key=b25b959554ed76058ac220b7b2e0a026">http://ws.audioscrobbler.com/2.0/?method=geo.getmetrotrackchart&country=spain&metro=madrid&api_...</a> 
    </p>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">metro</span> (Required) : The metro's name<br />
                <span class="param">country</span> (Required) : A country name, as defined by the ISO 3166-1 country names standard<br />
                <span class="param">start</span> (Optional) : Beginning timestamp of the weekly range requested (c.f. geo.getWeeklyChartlist)<br />
                <span class="param">end</span> (Optional) : Ending timestamp of the weekly range requested (c.f. geo.getWeeklyChartlist)<br />
                <span class="param">page</span> (Optional) : The page number to fetch.  Defaults to first page.<br />
                <span class="param">limit</span> (Optional) : The number of results to fetch per page. Defaults to 50.<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                     <h2>Auth</h2>
                                     
                           This service does <b>not</b> require authentication.
                        l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;?xml version=&quot;1.0&quot; encoding=&quot;utf-8&quot;?&gt;
&lt;lfm status=&quot;ok&quot;&gt;
    &lt;toptracks metro=&quot;Madrid&quot;&gt;
        &lt;track rank=&quot;1&quot;&gt;
            &lt;name&gt;Valiente&lt;/name&gt;
            &lt;playcount&gt;&lt;/playcount&gt;
            &lt;mbid&gt;&lt;/mbid&gt;
            &lt;url&gt;http://www.last.fm/music/Vetusta+Morla/_/Valiente&lt;/url&gt;
            &lt;streamable fulltrack=&quot;0&quot;&gt;0&lt;/streamable&gt;
            &lt;artist&gt;
                &lt;name&gt;Vetusta Morla&lt;/name&gt;
                &lt;mbid&gt;&lt;/mbid&gt;
                &lt;url&gt;http://www.last.fm/music/Vetusta+Morla&lt;/url&gt;
            &lt;/artist&gt;
        &lt;/track&gt;
        &lt;track rank=&quot;2&quot;&gt;
            &lt;name&gt;Copenhage&lt;/name&gt;
            &lt;playcount&gt;&lt;/playcount&gt;
            &lt;mbid&gt;&lt;/mbid&gt;
            &lt;url&gt;http://www.last.fm/music/+noredirect/Vetusta+Morla/_/Copenhage&lt;/url&gt;
            &lt;streamable fulltrack=&quot;0&quot;&gt;0&lt;/streamable&gt;
            &lt;artist&gt;
                &lt;name&gt;Vetusta Morla&lt;/name&gt;
                &lt;mbid&gt;&lt;/mbid&gt;
                &lt;url&gt;http://www.last.fm/music/Vetusta+Morla&lt;/url&gt;
            &lt;/artist&gt;
        &lt;/track&gt;
    &lt;/toptracks&gt;
    ...
&lt;/lfm&gt;</pre>
                                    </div>
                                
                    <h2>Other Formats</h2>
                            Also available as a feed in <b>rss</b> format                <p>
                                    e.g. <a href="http://ws.audioscrobbler.com/2.0/geo/spain/metrotrackchart.rss?metro=madrid">http://ws.audioscrobbler.com/2.0/geo/spain/metrotrackchart.rss?metro=madrid</a><br />
                                </p>
                                                <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>geo.getMetroUniqueArtistChart</h1>
    <div class="wsdescription">
        Get a chart of the artists which make that metro unique
    </div>
        <p class="sampleurl">
    e.g. <a href="http://ws.audioscrobbler.com/2.0/?method=geo.getmetrouniqueartistchart&country=spain&metro=madrid&api_key=b25b959554ed76058ac220b7b2e0a026">http://ws.audioscrobbler.com/2.0/?method=geo.getmetrouniqueartistchart&country=spain&metro=madr...</a> 
    </p>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">metro</span> (Required) : The metro's name<br />
                <span class="param">country</span> (Required) : A country name, as defined by the ISO 3166-1 country names standard<br />
                <span class="param">start</span> (Optional) : Beginning timestamp of the weekly range requested (c.f. geo.getWeeklyChartlist)<br />
                <span class="param">end</span> (Optional) : Ending timestamp of the weekly range requested (c.f. geo.getWeeklyChartlist)<br />
                <span class="param">page</span> (Optional) : The page number to fetch.  Defaults to first page.<br />
                <span class="param">limit</span> (Optional) : The number of results to fetch per page. Defaults to 50.<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                     <h2>Auth</h2>
                                     
                           This service does <b>not</b> require authentication.
                        l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;?xml version=&quot;1.0&quot; encoding=&quot;utf-8&quot;?&gt;
&lt;lfm status=&quot;ok&quot;&gt;
    &lt;topartists metro=&quot;Madrid&quot; &gt;
        &lt;artist rank=&quot;1&quot;&gt;
            &lt;name&gt;Muse&lt;/name&gt;
            &lt;playcount&gt;&lt;/playcount&gt;
            &lt;mbid&gt;9c9f1380-2516-4fc9-a3e6-f9f61941d090&lt;/mbid&gt;
            &lt;url&gt;http://www.last.fm/music/Muse&lt;/url&gt;
            &lt;streamable&gt;1&lt;/streamable&gt;
            &lt;image size=&quot;small&quot;&gt;http://userserve-ak.last.fm/serve/34/364188.jpg&lt;/image&gt;
            &lt;image size=&quot;medium&quot;&gt;http://userserve-ak.last.fm/serve/64/364188.jpg&lt;/image&gt;
            &lt;image size=&quot;large&quot;&gt;http://userserve-ak.last.fm/serve/126/364188.jpg&lt;/image&gt;
            &lt;image size=&quot;extralarge&quot;&gt;http://userserve-ak.last.fm/serve/252/364188.jpg&lt;/image&gt;
            &lt;image size=&quot;mega&quot;&gt;&lt;/image&gt;
        &lt;/artist&gt;
        &lt;artist rank=&quot;2&quot;&gt;
            &lt;name&gt;The Killers&lt;/name&gt;
            &lt;playcount&gt;&lt;/playcount&gt;
            &lt;mbid&gt;95e1ead9-4d31-4808-a7ac-32c3614c116b&lt;/mbid&gt;
            &lt;url&gt;http://www.last.fm/music/The+Killers&lt;/url&gt;
            &lt;streamable&gt;1&lt;/streamable&gt;
            &lt;image size=&quot;small&quot;&gt;http://userserve-ak.last.fm/serve/34/95070.jpg&lt;/image&gt;
            &lt;image size=&quot;medium&quot;&gt;http://userserve-ak.last.fm/serve/64/95070.jpg&lt;/image&gt;
            &lt;image size=&quot;large&quot;&gt;http://userserve-ak.last.fm/serve/126/95070.jpg&lt;/image&gt;
            &lt;image size=&quot;extralarge&quot;&gt;http://userserve-ak.last.fm/serve/252/95070.jpg&lt;/image&gt;
            &lt;image size=&quot;mega&quot;&gt;&lt;/image&gt;
        &lt;/artist&gt;
        ...
    &lt;/topartists&gt;
&lt;/lfm&gt;</pre>
                                    </div>
                                
                    <h2>Other Formats</h2>
                            Also available as a feed in <b>rss</b> format                <p>
                                    e.g. <a href="http://ws.audioscrobbler.com/2.0/geo/spain/metrouniqueartistchart.rss?metro=madrid">http://ws.audioscrobbler.com/2.0/geo/spain/metrouniqueartistchart.rss?metro=madrid</a><br />
                                </p>
                                                <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>geo.getMetroUniqueTrackChart</h1>
    <div class="wsdescription">
        Get a chart of tracks for a metro
    </div>
        <p class="sampleurl">
    e.g. <a href="http://ws.audioscrobbler.com/2.0/?method=geo.getmetrouniquetrackchart&country=spain&metro=madrid&api_key=b25b959554ed76058ac220b7b2e0a026">http://ws.audioscrobbler.com/2.0/?method=geo.getmetrouniquetrackchart&country=spain&metro=madri...</a> 
    </p>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">metro</span> (Required) : The metro's name<br />
                <span class="param">country</span> (Required) : A country name, as defined by the ISO 3166-1 country names standard<br />
                <span class="param">start</span> (Optional) : Beginning timestamp of the weekly range requested (c.f. geo.getWeeklyChartlist)<br />
                <span class="param">end</span> (Optional) : Ending timestamp of the weekly range requested (c.f. geo.getWeeklyChartlist)<br />
                <span class="param">page</span> (Optional) : The page number to fetch.  Defaults to first page.<br />
                <span class="param">limit</span> (Optional) : The number of results to fetch per page. Defaults to 50.<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                     <h2>Auth</h2>
                                     
                           This service does <b>not</b> require authentication.
                        l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;?xml version=&quot;1.0&quot; encoding=&quot;utf-8&quot;?&gt;
&lt;lfm status=&quot;ok&quot;&gt;
    &lt;toptracks metro=&quot;Madrid&quot;&gt;
        &lt;track rank=&quot;1&quot;&gt;
            &lt;name&gt;Valiente&lt;/name&gt;
            &lt;playcount&gt;&lt;/playcount&gt;
            &lt;mbid&gt;&lt;/mbid&gt;
            &lt;url&gt;http://www.last.fm/music/Vetusta+Morla/_/Valiente&lt;/url&gt;
            &lt;streamable fulltrack=&quot;0&quot;&gt;0&lt;/streamable&gt;
            &lt;artist&gt;
                &lt;name&gt;Vetusta Morla&lt;/name&gt;
                &lt;mbid&gt;&lt;/mbid&gt;
                &lt;url&gt;http://www.last.fm/music/Vetusta+Morla&lt;/url&gt;
            &lt;/artist&gt;
        &lt;/track&gt;
        &lt;track rank=&quot;2&quot;&gt;
            &lt;name&gt;Copenhage&lt;/name&gt;
            &lt;playcount&gt;&lt;/playcount&gt;
            &lt;mbid&gt;&lt;/mbid&gt;
            &lt;url&gt;http://www.last.fm/music/+noredirect/Vetusta+Morla/_/Copenhage&lt;/url&gt;
            &lt;streamable fulltrack=&quot;0&quot;&gt;0&lt;/streamable&gt;
            &lt;artist&gt;
                &lt;name&gt;Vetusta Morla&lt;/name&gt;
                &lt;mbid&gt;&lt;/mbid&gt;
                &lt;url&gt;http://www.last.fm/music/Vetusta+Morla&lt;/url&gt;
            &lt;/artist&gt;
        &lt;/track&gt;
    &lt;/toptracks&gt;
    ...
&lt;/lfm&gt;</pre>
                                    </div>
                                
                    <h2>Other Formats</h2>
                            Also available as a feed in <b>rss</b> format                <p>
                                    e.g. <a href="http://ws.audioscrobbler.com/2.0/geo/spain/metrouniquetrackchart.rss?metro=madrid">http://ws.audioscrobbler.com/2.0/geo/spain/metrouniquetrackchart.rss?metro=madrid</a><br />
                                </p>
                                                <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>geo.getMetroWeeklyChartlist</h1>
    <div class="wsdescription">
        Get a list of available chart periods for this metro, expressed as date
ranges which can be sent to the chart services.
    </div>
        <p class="sampleurl">
    e.g. <a href="http://ws.audioscrobbler.com/2.0/?method=geo.getmetroweeklychartlist&api_key=b25b959554ed76058ac220b7b2e0a026">http://ws.audioscrobbler.com/2.0/?method=geo.getmetroweeklychartlist&api_key=b25b959554ed76058a...</a> 
    </p>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">metro</span> : The metro name to fetch the charts list for.<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                     <h2>Auth</h2>
                                     
                           This service does <b>not</b> require authentication.
                        l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;?xml version=&quot;1.0&quot; encoding=&quot;utf-8&quot;?&gt;
&lt;lfm status=&quot;ok&quot;&gt;
&lt;weeklychartlist&gt;
    &lt;chart from=&quot;1233489600&quot; to=&quot;1234094400&quot;/&gt;
    &lt;chart from=&quot;1234094400&quot; to=&quot;1234699200&quot;/&gt;
    &lt;chart from=&quot;1234699200&quot; to=&quot;1235304000&quot;/&gt;
    &lt;chart from=&quot;1235304000&quot; to=&quot;1235908800&quot;/&gt;
    &lt;chart from=&quot;1235908800&quot; to=&quot;1236513600&quot;/&gt;
    ...
&lt;/weeklychartlist&gt;&lt;/lfm&gt;</pre>
                                    </div>
                                
                                    <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>geo.getMetros</h1>
    <div class="wsdescription">
        Get a list of valid countries and metros for use in the other webservices
    </div>
        <p class="sampleurl">
    e.g. <a href="http://ws.audioscrobbler.com/2.0/?method=geo.getmetros&country=spain&api_key=b25b959554ed76058ac220b7b2e0a026">http://ws.audioscrobbler.com/2.0/?method=geo.getmetros&country=spain&api_key=b25b959554ed76058a...</a> 
    </p>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">country</span> (Optional) : Optionally restrict the results to those Metros from a particular country, as defined by the ISO 3166-1 country names standard<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                     <h2>Auth</h2>
                                     
                           This service does <b>not</b> require authentication.
                        l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;metros&gt;
    &lt;metro&gt;
    &lt;name&gt;Valencia&lt;/name&gt;
    &lt;country&gt;Spain&lt;/country&gt;
    &lt;/metro&gt;
    ....
&lt;/metros&gt;</pre>
                                    </div>
                                
                                    <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>geo.getTopArtists</h1>
    <div class="wsdescription">
        Get the most popular artists on Last.fm by country
    </div>
        <p class="sampleurl">
    e.g. <a href="http://ws.audioscrobbler.com/2.0/?method=geo.gettopartists&country=spain&api_key=b25b959554ed76058ac220b7b2e0a026">http://ws.audioscrobbler.com/2.0/?method=geo.gettopartists&country=spain&api_key=b25b959554ed76...</a> 
    </p>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">country</span> (Required) : A country name, as defined by the ISO 3166-1 country names standard<br />
                <span class="param">limit</span> (Optional) : The number of results to fetch per page. Defaults to 50.<br />
                <span class="param">page</span> (Optional) : The page number to fetch.  Defaults to first page.<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                     <h2>Auth</h2>
                                     
                           This service does <b>not</b> require authentication.
                        l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;topartists country=&quot;Spain&quot;&gt;
  &lt;artist rank=&quot;1&quot;&gt;
    &lt;name&gt;Coldplay&lt;/name&gt;
    &lt;playcount&gt;3199&lt;/playcount&gt;
    &lt;mbid&gt;cc197bad-dc9c-440d-a5b5-d52ba2e14234&lt;/mbid&gt;
    &lt;url&gt;http://www.last.fm/music/Coldplay&lt;/url&gt;
    &lt;streamable&gt;1&lt;/streamable&gt;
    &lt;image size=&quot;small&quot;&gt;...&lt;/image&gt;
    &lt;image size=&quot;medium&quot;&gt;...&lt;/image&gt;
    &lt;image size=&quot;large&quot;&gt;...&lt;/image&gt;
  &lt;/artist&gt;
  ...
&lt;/topartists&gt;</pre>
                                    </div>
                                
                    <h2>Other Formats</h2>
                            Also available as a feed in <b>rss,csv</b> formats                <p>
                                    e.g. <a href="http://ws.audioscrobbler.com/2.0/geo/spain/topartists.rss">http://ws.audioscrobbler.com/2.0/geo/spain/topartists.rss</a><br />
                                    e.g. <a href="http://ws.audioscrobbler.com/2.0/geo/spain/topartists.csv">http://ws.audioscrobbler.com/2.0/geo/spain/topartists.csv</a><br />
                                </p>
                                                <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>geo.getTopTracks</h1>
    <div class="wsdescription">
        Get the most popular tracks on Last.fm last week by country
    </div>
        <p class="sampleurl">
    e.g. <a href="http://ws.audioscrobbler.com/2.0/?method=geo.gettoptracks&country=spain&api_key=b25b959554ed76058ac220b7b2e0a026">http://ws.audioscrobbler.com/2.0/?method=geo.gettoptracks&country=spain&api_key=b25b959554ed760...</a> 
    </p>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">country</span> (Required) : A country name, as defined by the ISO 3166-1 country names standard<br />
                <span class="param">location</span> (Optional) : A metro name, to fetch the charts for (must be within the country specified)<br />
                <span class="param">limit</span> (Optional) : The number of results to fetch per page. Defaults to 50.<br />
                <span class="param">page</span> (Optional) : The page number to fetch.  Defaults to first page.<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                     <h2>Auth</h2>
                                     
                           This service does <b>not</b> require authentication.
                        l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;toptracks country=&quot;Spain&quot;&gt;  
  &lt;track rank=&quot;1&quot;&gt;
    &lt;name&gt;Violet Hill&lt;/name&gt;
    &lt;playcount&gt;1055&lt;/playcount&gt;
    &lt;mbid/&gt;
    &lt;url&gt;http://www.last.fm/music/Coldplay/_/Violet+Hill&lt;/url&gt;
    &lt;streamable fulltrack=&quot;0&quot;&gt;1&lt;/streamable&gt;
    &lt;artist&gt;
      &lt;name&gt;Coldplay&lt;/name&gt;
      &lt;mbid&gt;cc197bad-dc9c-440d-a5b5-d52ba2e14234&lt;/mbid&gt;
      &lt;url&gt;http://www.last.fm/music/Coldplay&lt;/url&gt;
    &lt;/artist&gt;
    &lt;image size=&quot;small&quot;&gt;...&lt;/image&gt;
    &lt;image size=&quot;medium&quot;&gt;...&lt;/image&gt;
    &lt;image size=&quot;large&quot;&gt;...&lt;/image&gt;
  &lt;/track&gt;
  ...
&lt;/toptracks&gt;</pre>
                                    </div>
                                
                    <h2>Other Formats</h2>
                            Also available as a feed in <b>rss,csv</b> formats                <p>
                                    e.g. <a href="http://ws.audioscrobbler.com/2.0/geo/spain/toptracks.rss">http://ws.audioscrobbler.com/2.0/geo/spain/toptracks.rss</a><br />
                                    e.g. <a href="http://ws.audioscrobbler.com/2.0/geo/spain/toptracks.csv">http://ws.audioscrobbler.com/2.0/geo/spain/toptracks.csv</a><br />
                                </p>
                                                <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>group.getHype</h1>
    <div class="wsdescription">
        Get the hype list for a group
    </div>
        <p class="sampleurl">
    e.g. <a href="http://ws.audioscrobbler.com/2.0/?method=group.gethype&group=radiohead&api_key=b25b959554ed76058ac220b7b2e0a026">http://ws.audioscrobbler.com/2.0/?method=group.gethype&group=radiohead&api_key=b25b959554ed7605...</a> 
    </p>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">Group</span> (Required) : The last.fm group name<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                     <h2>Auth</h2>
                                     
                           This service does <b>not</b> require authentication.
                        l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;weeklyartistchart group=&quot;radiohead&quot; from=&quot;1274011200&quot; to=&quot;1274616000&quot;&gt;
    &lt;artist rank=&quot;1&quot;&gt;
    &lt;name&gt;Dio&lt;/name&gt;
    &lt;mbid&gt;c55193fb-f5d2-4839-a263-4c044fca1456&lt;/mbid&gt;
    &lt;chartposition/&gt;
    &lt;reach/&gt;
    &lt;url&gt;www.last.fm/music/Dio&lt;/url&gt;
    &lt;weight&gt;680&lt;/weight&gt;
    &lt;/artist&gt;
    ...
&lt;/weeklyartistchart&gt;</pre>
                                    </div>
                                
                                    <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>group.getMembers</h1>
    <div class="wsdescription">
        Get a list of members for this group.
    </div>
        <p class="sampleurl">
    e.g. <a href="http://ws.audioscrobbler.com/2.0/?method=group.getmembers&api_key=b25b959554ed76058ac220b7b2e0a026&group=mnml">http://ws.audioscrobbler.com/2.0/?method=group.getmembers&api_key=b25b959554ed76058ac220b7b2e0a...</a> 
    </p>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">group</span> (Required) : The group name to fetch the members of.<br />
                <span class="param">page</span> (Optional) : The results page you would like to fetch<br />
                <span class="param">limit</span> (Optional) : The number of results to fetch per page. Defaults to 50.<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                     <h2>Auth</h2>
                                     
                           This service does <b>not</b> require authentication.
                        l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;members for=&quot;mnml&quot; page=&quot;4&quot; perPage=&quot;50&quot; totalPages=&quot;23&quot;&gt;
  &lt;user&gt;
    &lt;name&gt;sonicsson&lt;/name&gt;
    &lt;realname&gt;kai&lt;/realname&gt;
    &lt;image size=&quot;small&quot;&gt;...&lt;/image&gt;
    &lt;image size=&quot;medium&quot;&gt;...&lt;/image&gt;
    &lt;image size=&quot;large&quot;&gt;...&lt;/image&gt;
    &lt;url&gt;http://www.last.fm/user/sonicsson&lt;/url&gt;
  &lt;/user&gt;
  &lt;user&gt;
    &lt;name&gt;zorax&lt;/name&gt;
    &lt;realname&gt;Long Island , New York&lt;/realname&gt;
    &lt;image size=&quot;small&quot;&gt;...&lt;/image&gt;
    &lt;image size=&quot;medium&quot;&gt;...&lt;/image&gt;
    &lt;image size=&quot;large&quot;&gt;...&lt;/image&gt;
    &lt;url&gt;http://www.last.fm/user/zorax&lt;/url&gt;
  &lt;/user&gt;
&lt;/members&gt;</pre>
                                    </div>
                                
                                    <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>group.getWeeklyAlbumChart</h1>
    <div class="wsdescription">
        Get an album chart for a group, for a given date range. If no date range is
supplied, it will return the most recent album chart for this group.
    </div>
        <p class="sampleurl">
    e.g. <a href="http://ws.audioscrobbler.com/2.0/?method=group.getweeklyalbumchart&group=mnml&api_key=b25b959554ed76058ac220b7b2e0a026">http://ws.audioscrobbler.com/2.0/?method=group.getweeklyalbumchart&group=mnml&api_key=b25b95955...</a> 
    </p>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">group</span> (Required) : The last.fm group name to fetch the charts of.<br />
                <span class="param">from</span> (Optional) : The date at which the chart should start from. See Group.getWeeklyChartList for more.<br />
                <span class="param">to</span> (Optional) : The date at which the chart should end on. See Group.getWeeklyChartList for more.<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                     <h2>Auth</h2>
                                     
                           This service does <b>not</b> require authentication.
                        l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;weeklyalbumchart group=&quot;mnml&quot; from=&quot;1212321600&quot; to=&quot;1212926400&quot;&gt;
  &lt;album rank=&quot;1&quot;&gt;
    &lt;artist mbid=&quot;9ddce51c-2b75-4b3e-ac8c-1db09e7c89c6&quot;&gt;Burial&lt;/artist&gt;
    &lt;name&gt;Untrue&lt;/name&gt;
    &lt;mbid/&gt;
    &lt;playcount&gt;35&lt;/playcount&gt;
    &lt;url&gt;http://www.last.fm/music/Burial/Untrue&lt;/url&gt;
  &lt;/album&gt;
  ...
&lt;/weeklyalbumchart&gt;</pre>
                                    </div>
                                
                                    <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>group.getWeeklyArtistChart</h1>
    <div class="wsdescription">
        Get an artist chart for a group, for a given date range. If no date range
is supplied, it will return the most recent album chart for this group.
    </div>
        <p class="sampleurl">
    e.g. <a href="http://ws.audioscrobbler.com/2.0/?method=group.getweeklyartistchart&group=mnml&api_key=b25b959554ed76058ac220b7b2e0a026">http://ws.audioscrobbler.com/2.0/?method=group.getweeklyartistchart&group=mnml&api_key=b25b9595...</a> 
    </p>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">group</span> (Required) : The last.fm group name to fetch the charts of.<br />
                <span class="param">from</span> (Optional) : The date at which the chart should start from. See Group.getWeeklyChartList for more.<br />
                <span class="param">to</span> (Optional) : The date at which the chart should end on. See Group.getWeeklyChartList for more.<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                     <h2>Auth</h2>
                                     
                           This service does <b>not</b> require authentication.
                        l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;weeklyartistchart group=&quot;mnml&quot; from=&quot;1212321600&quot; to=&quot;1212926400&quot;&gt;
  &lt;artist rank=&quot;1&quot;&gt;
    &lt;name&gt;Booka Shade&lt;/name&gt;
    &lt;mbid&gt;9940c604-2456-4193-a403-ab18420bc1e9&lt;/mbid&gt;
    &lt;playcount&gt;74&lt;/playcount&gt;
    &lt;url&gt;http://www.last.fm/music/Booka+Shade&lt;/url&gt;
  &lt;/artist&gt;
  ...
&lt;/weeklyartistchart&gt;</pre>
                                    </div>
                                
                                    <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>group.getWeeklyChartList</h1>
    <div class="wsdescription">
        Get a list of available charts for this group, expressed as date ranges
which can be sent to the chart services.
    </div>
        <p class="sampleurl">
    e.g. <a href="http://ws.audioscrobbler.com/2.0/?method=group.getweeklychartlist&group=mnml&api_key=b25b959554ed76058ac220b7b2e0a026">http://ws.audioscrobbler.com/2.0/?method=group.getweeklychartlist&group=mnml&api_key=b25b959554...</a> 
    </p>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">group</span> (Required) : The last.fm group name to fetch the charts list for.<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                     <h2>Auth</h2>
                                     
                           This service does <b>not</b> require authentication.
                        l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;weeklychartlist group=&quot;mnml&quot;&gt;
  &lt;chart from=&quot;1159099200&quot; to=&quot;1159704000&quot;/&gt;
  &lt;chart from=&quot;1159704000&quot; to=&quot;1160308800&quot;/&gt;
  ...
&lt;/weeklychartlist&gt;</pre>
                                    </div>
                                
                                    <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>group.getWeeklyTrackChart</h1>
    <div class="wsdescription">
        Get a track chart for a group, for a given date range. If no date range is
supplied, it will return the most recent album chart for this group.
    </div>
        <p class="sampleurl">
    e.g. <a href="http://ws.audioscrobbler.com/2.0/?method=group.getweeklytrackchart&group=mnml&api_key=b25b959554ed76058ac220b7b2e0a026">http://ws.audioscrobbler.com/2.0/?method=group.getweeklytrackchart&group=mnml&api_key=b25b95955...</a> 
    </p>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">group</span> (Required) : The last.fm group name to fetch the charts of.<br />
                <span class="param">from</span> (Optional) : The date at which the chart should start from. See Group.getWeeklyChartList for more.<br />
                <span class="param">to</span> (Optional) : The date at which the chart should end on. See Group.getWeeklyChartList for more.<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                     <h2>Auth</h2>
                                     
                           This service does <b>not</b> require authentication.
                        l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;weeklytrackchart group=&quot;mnml&quot; from=&quot;1212321600&quot; to=&quot;1212926400&quot;&gt;
  &lt;track rank=&quot;1&quot;&gt;
    &lt;artist mbid=&quot;9940c604-2456-4193-a403-ab18420bc1e9&quot;&gt;Booka Shade&lt;/artist&gt;
    &lt;name&gt;Charlotte&lt;/name&gt;
    &lt;mbid/&gt;
    &lt;playcount&gt;18&lt;/playcount&gt;
    &lt;url&gt;http://www.last.fm/music/Booka+Shade/_/Charlotte&lt;/url&gt;
  &lt;/track&gt;
  ...
&lt;/weeklytrackchart&gt;</pre>
                                    </div>
                                
                                    <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>library.addAlbum</h1>
    <div class="wsdescription">
        Add an album or collection of albums to a user's Last.fm library
    </div>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">artist[i]</span> (Required) : The artist or collection of artists that you wish to add.<br />
                <span class="param">album[i]</span> (Required) : The album or collection of albums that you wish to add. The indices of the albums that you pass MUST correspond to those of the artists.<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                  <span class="param">api_sig</span> (Required) : A Last.fm method signature. See <a href="/api/authentication">authentication</a> for more information.<br />
                     <span class="param">sk</span> (Required) : A session key generated by authenticating a user via the authentication protocol.
                              <h2>Auth</h2>
                                     
                           This service requires authentication. Please see our <a href="/api/authentication">authentication</a> how-to.<br/>
                                        This is a <b>write</b> service and must be accessed with an HTTP POST request. All parameters should be sent in the POST body, including the 'method' parameter. See <a href="/api/rest">rest requests</a> for more information.
            l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;lfm status=&quot;ok&quot;&gt;&lt;/lfm&gt;</pre>
                                    </div>
                                
                                    <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>library.addArtist</h1>
    <div class="wsdescription">
        Add an artist to a user's Last.fm library
    </div>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">artist[i]</span> (Required) : The artist or collection of artists you wish to add.<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                  <span class="param">api_sig</span> (Required) : A Last.fm method signature. See <a href="/api/authentication">authentication</a> for more information.<br />
                     <span class="param">sk</span> (Required) : A session key generated by authenticating a user via the authentication protocol.
                              <h2>Auth</h2>
                                     
                           This service requires authentication. Please see our <a href="/api/authentication">authentication</a> how-to.<br/>
                                        This is a <b>write</b> service and must be accessed with an HTTP POST request. All parameters should be sent in the POST body, including the 'method' parameter. See <a href="/api/rest">rest requests</a> for more information.
            l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;lfm status=&quot;ok&quot;&gt;&lt;/lfm&gt;</pre>
                                    </div>
                                
                                    <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>library.addTrack</h1>
    <div class="wsdescription">
        Add a track to a user's Last.fm library
    </div>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">artist</span> (Required) : The artist that composed the track<br />
                <span class="param">track</span> (Required) : The track name you wish to add<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                  <span class="param">api_sig</span> (Required) : A Last.fm method signature. See <a href="/api/authentication">authentication</a> for more information.<br />
                     <span class="param">sk</span> (Required) : A session key generated by authenticating a user via the authentication protocol.
                              <h2>Auth</h2>
                                     
                           This service requires authentication. Please see our <a href="/api/authentication">authentication</a> how-to.<br/>
                                        This is a <b>write</b> service and must be accessed with an HTTP POST request. All parameters should be sent in the POST body, including the 'method' parameter. See <a href="/api/rest">rest requests</a> for more information.
            l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;lfm status=&quot;ok&quot;&gt;&lt;/lfm&gt;</pre>
                                    </div>
                                
                                    <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>library.getAlbums</h1>
    <div class="wsdescription">
        A paginated list of all the albums in a user's library, with play
counts and tag counts.
    </div>
        <p class="sampleurl">
    e.g. <a href="http://ws.audioscrobbler.com/2.0/?method=library.getalbums&api_key=b25b959554ed76058ac220b7b2e0a026&user=joanofarctan">http://ws.audioscrobbler.com/2.0/?method=library.getalbums&api_key=b25b959554ed76058ac220b7b2e0...</a> 
    </p>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">user</span> (Required) : The user whose library you want to fetch.<br />
                <span class="param">artist</span> (Optional) : An artist by which to filter tracks<br />
                <span class="param">limit</span> (Optional) : The number of results to fetch per page. Defaults to 50.<br />
                <span class="param">page</span> (Optional) : The page number you wish to scan to.<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                     <h2>Auth</h2>
                                     
                           This service does <b>not</b> require authentication.
                        l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;albums user=&quot;RJ&quot; page=&quot;1&quot; perPage=&quot;50&quot; totalPages=&quot;20&quot;&gt;
  &lt;album rank=&quot;1&quot;&gt;
    &lt;name&gt;Images and Words&lt;/name&gt;
    &lt;playcount&gt;183&lt;/playcount&gt;
    &lt;tagcount&gt;0&lt;/tagcount&gt;
    &lt;mbid&gt;f20971f2-c8ad-4d26-91ab-730f6dedafb2&lt;/mbid&gt;
    &lt;url&gt;http://www.last.fm/music/Dream+Theater/Images+and+Words&lt;/url&gt;
    &lt;artist&gt;
      &lt;name&gt;Dream Theater&lt;/name&gt;
      &lt;mbid&gt;28503ab7-8bf2-4666-a7bd-2644bfc7cb1d&lt;/mbid&gt;
      &lt;url&gt;http://www.last.fm/music/Dream+Theater&lt;/url&gt;
    &lt;/artist&gt;
    &lt;image size=&quot;small&quot;&gt;...&lt;/image&gt;
    &lt;image size=&quot;medium&quot;&gt;...&lt;/image&gt;
    &lt;image size=&quot;large&quot;&gt;...&lt;/image&gt;
  &lt;/album&gt;
  ...
&lt;/albums&gt;</pre>
                                    </div>
                                
                                    <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>library.getArtists</h1>
    <div class="wsdescription">
        A paginated list of all the artists in a user's library, with play
counts and tag counts.
    </div>
        <p class="sampleurl">
    e.g. <a href="http://ws.audioscrobbler.com/2.0/?method=library.getartists&api_key=b25b959554ed76058ac220b7b2e0a026&user=joanofarctan">http://ws.audioscrobbler.com/2.0/?method=library.getartists&api_key=b25b959554ed76058ac220b7b2e...</a> 
    </p>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">user</span> (Required) : The user whose library you want to fetch.<br />
                <span class="param">limit</span> (Optional) : The number of results to fetch per page. Defaults to 50.<br />
                <span class="param">page</span> (Optional) : The page number you wish to scan to.<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                     <h2>Auth</h2>
                                     
                           This service does <b>not</b> require authentication.
                        l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;artists user=&quot;RJ&quot; page=&quot;1&quot; perPage=&quot;50&quot; totalPages=&quot;20&quot;&gt;
  &lt;artist rank=&quot;1&quot;&gt;
    &lt;name&gt;Dream Theater&lt;/name&gt;
    &lt;playcount&gt;1346&lt;/playcount&gt;
    &lt;tagcount&gt;0&lt;/tagcount&gt;
    &lt;mbid&gt;28503ab7-8bf2-4666-a7bd-2644bfc7cb1d&lt;/mbid&gt;
    &lt;url&gt;http://www.last.fm/music/Dream+Theater&lt;/url&gt;
    &lt;streamable&gt;1&lt;/streamable&gt;
    &lt;image size=&quot;small&quot;&gt;http://userserve-ak.last.fm/serve/50/95853.jpg&lt;/image&gt;
    &lt;image size=&quot;medium&quot;&gt;http://userserve-ak.last.fm/serve/85/95853.jpg&lt;/image&gt;
    &lt;image size=&quot;large&quot;&gt;http://userserve-ak.last.fm/serve/160/95853.jpg&lt;/image&gt;
  &lt;/artist&gt;
  ...
&lt;/artists&gt;</pre>
                                    </div>
                                
                                    <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>library.getTracks</h1>
    <div class="wsdescription">
        A paginated list of all the tracks in a user's library, with play
counts and tag counts.
    </div>
        <p class="sampleurl">
    e.g. <a href="http://ws.audioscrobbler.com/2.0/?method=library.gettracks&api_key=b25b959554ed76058ac220b7b2e0a026&user=joanofarctan">http://ws.audioscrobbler.com/2.0/?method=library.gettracks&api_key=b25b959554ed76058ac220b7b2e0...</a> 
    </p>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">user</span> (Required) : The user whose library you want to fetch.<br />
                <span class="param">artist</span> (Optional) : An artist by which to filter tracks<br />
                <span class="param">album</span> (Optional) : An album by which to filter tracks (needs an artist)<br />
                <span class="param">page</span> (Optional) : The page number you wish to scan to.<br />
                <span class="param">limit</span> (Optional) : The number of results to fetch per page. Defaults to 50.<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                     <h2>Auth</h2>
                                     
                           This service does <b>not</b> require authentication.
                        l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;tracks user=&quot;RJ&quot; page=&quot;1&quot; perPage=&quot;50&quot; totalPages=&quot;20&quot;&gt;
&lt;track rank=&quot;1&quot;&gt;
    &lt;name&gt;Learning to Live&lt;/name&gt;
    &lt;playcount&gt;44&lt;/playcount&gt;
    &lt;tagcount&gt;0&lt;/tagcount&gt;
    &lt;mbid&gt;&lt;/mbid&gt;
    &lt;url&gt;http://www.last.fm/music/Dream+Theater/_/Learning+to+Live&lt;/url&gt;
    &lt;streamable fulltrack=&quot;0&quot;&gt;1&lt;/streamable&gt;
        &lt;artist&gt;
        &lt;name&gt;Dream Theater&lt;/name&gt;
        &lt;mbid&gt;28503ab7-8bf2-4666-a7bd-2644bfc7cb1d&lt;/mbid&gt;
        &lt;url&gt;http://www.last.fm/music/Dream+Theater&lt;/url&gt;
    &lt;/artist&gt;
    &lt;image size=&quot;small&quot;&gt;...&lt;/image&gt;
    &lt;image size=&quot;medium&quot;&gt;...&lt;/image&gt;
    &lt;image size=&quot;large&quot;&gt;...&lt;/image&gt;
    &lt;/track&gt;
&lt;/tracks&gt;</pre>
                                    </div>
                                
                                    <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>library.removeAlbum</h1>
    <div class="wsdescription">
        Remove an album from a user's Last.fm library
    </div>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">artist</span> (Required) : The artist that composed the album<br />
                <span class="param">album</span> (Required) : The name of the album you wish to remove<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                  <span class="param">api_sig</span> (Required) : A Last.fm method signature. See <a href="/api/authentication">authentication</a> for more information.<br />
                     <span class="param">sk</span> (Required) : A session key generated by authenticating a user via the authentication protocol.
                              <h2>Auth</h2>
                                     
                           This service requires authentication. Please see our <a href="/api/authentication">authentication</a> how-to.<br/>
                                        This is a <b>write</b> service and must be accessed with an HTTP POST request. All parameters should be sent in the POST body, including the 'method' parameter. See <a href="/api/rest">rest requests</a> for more information.
            l
            <h2>Sample Response</h2>
                                
                                    <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>library.removeArtist</h1>
    <div class="wsdescription">
        Remove an artist from a user's Last.fm library
    </div>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">artist</span> (Required) : The artist name you wish to remove<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                  <span class="param">api_sig</span> (Required) : A Last.fm method signature. See <a href="/api/authentication">authentication</a> for more information.<br />
                     <span class="param">sk</span> (Required) : A session key generated by authenticating a user via the authentication protocol.
                              <h2>Auth</h2>
                                     
                           This service requires authentication. Please see our <a href="/api/authentication">authentication</a> how-to.<br/>
                                        This is a <b>write</b> service and must be accessed with an HTTP POST request. All parameters should be sent in the POST body, including the 'method' parameter. See <a href="/api/rest">rest requests</a> for more information.
            l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre></pre>
                                    </div>
                                
                                    <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>library.removeScrobble</h1>
    <div class="wsdescription">
        Remove a scrobble from a user's Last.fm library
    </div>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">artist</span> (Required) : The artist that composed the track<br />
                <span class="param">track</span> (Required) : The name of the track<br />
                <span class="param">timestamp</span> (Required) : The unix timestamp of the scrobble that you wish to remove<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                  <span class="param">api_sig</span> (Required) : A Last.fm method signature. See <a href="/api/authentication">authentication</a> for more information.<br />
                     <span class="param">sk</span> (Required) : A session key generated by authenticating a user via the authentication protocol.
                              <h2>Auth</h2>
                                     
                           This service requires authentication. Please see our <a href="/api/authentication">authentication</a> how-to.<br/>
                                        This is a <b>write</b> service and must be accessed with an HTTP POST request. All parameters should be sent in the POST body, including the 'method' parameter. See <a href="/api/rest">rest requests</a> for more information.
            l
            <h2>Sample Response</h2>
                                
                                    <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>library.removeTrack</h1>
    <div class="wsdescription">
        Remove a track from a user's Last.fm library
    </div>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">artist</span> (Required) : The artist that composed the track<br />
                <span class="param">track</span> (Required) : The name of the track that you wish to remove<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                  <span class="param">api_sig</span> (Required) : A Last.fm method signature. See <a href="/api/authentication">authentication</a> for more information.<br />
                     <span class="param">sk</span> (Required) : A session key generated by authenticating a user via the authentication protocol.
                              <h2>Auth</h2>
                                     
                           This service requires authentication. Please see our <a href="/api/authentication">authentication</a> how-to.<br/>
                                        This is a <b>write</b> service and must be accessed with an HTTP POST request. All parameters should be sent in the POST body, including the 'method' parameter. See <a href="/api/rest">rest requests</a> for more information.
            l
            <h2>Sample Response</h2>
                                
                                    <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>playlist.addTrack</h1>
    <div class="wsdescription">
        Add a track to a Last.fm user's playlist
    </div>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">playlistID</span> (Required) : The ID of the playlist - this is available in user.getPlaylists.<br />
                <span class="param">track</span> (Required) : The track name to add to the playlist.<br />
                <span class="param">artist</span> (Required) : The artist name that corresponds to the track to be added.<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                  <span class="param">api_sig</span> (Required) : A Last.fm method signature. See <a href="/api/authentication">authentication</a> for more information.<br />
                     <span class="param">sk</span> (Required) : A session key generated by authenticating a user via the authentication protocol.
                              <h2>Auth</h2>
                                     
                           This service requires authentication. Please see our <a href="/api/authentication">authentication</a> how-to.<br/>
                                        This is a <b>write</b> service and must be accessed with an HTTP POST request. All parameters should be sent in the POST body, including the 'method' parameter. See <a href="/api/rest">rest requests</a> for more information.
            l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;lfm status=&quot;ok&quot;&gt;
&lt;/lfm&gt;</pre>
                                    </div>
                                
                                    <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>playlist.create</h1>
    <div class="wsdescription">
        Create a Last.fm playlist on behalf of a user
    </div>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">title</span> (Optional) : Title for the playlist<br />
                <span class="param">description</span> (Optional) : Description for the playlist<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                  <span class="param">api_sig</span> (Required) : A Last.fm method signature. See <a href="/api/authentication">authentication</a> for more information.<br />
                     <span class="param">sk</span> (Required) : A session key generated by authenticating a user via the authentication protocol.
                              <h2>Auth</h2>
                                     
                           This service requires authentication. Please see our <a href="/api/authentication">authentication</a> how-to.<br/>
                                        This is a <b>write</b> service and must be accessed with an HTTP POST request. All parameters should be sent in the POST body, including the 'method' parameter. See <a href="/api/rest">rest requests</a> for more information.
            l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;playlists user=&quot;RJ&quot;&gt;
  &lt;playlist&gt;
    &lt;id&gt;2615079&lt;/id&gt;
    &lt;title&gt;Duck playlist&lt;/title&gt;
    &lt;description&gt;Duck and cover&lt;/description&gt;
    &lt;date&gt;2008-05-22T09:40:09&lt;/date&gt;
    &lt;size&gt;0&lt;/size&gt;
    &lt;duration&gt;0&lt;/duration&gt;
    &lt;streamable&gt;0&lt;/streamable&gt;
    &lt;creator&gt;http://www.last.fm/user/RJ&lt;/creator&gt;
    &lt;url&gt;http://www.last.fm/user/RJ/library/playlists/1k1t3_duck_playlist&lt;/url&gt;
    &lt;image size=&quot;small&quot;&gt;&lt;/image&gt;
    &lt;image size=&quot;medium&quot;&gt;&lt;/image&gt;
    &lt;image size=&quot;large&quot;&gt;&lt;/image&gt;
  &lt;/playlist&gt;
&lt;/playlists&gt;</pre>
                                    </div>
                                
                                    <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>radio.getPlaylist</h1>
    <div class="wsdescription">
        Fetch new radio content periodically in an XSPF format.
    </div>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">discovery</span> (Optional) : Whether to request last.fm content with discovery mode switched on.<br />
                <span class="param">buylinks</span> (Optional) : Whether the response should contain links for purchase/download, if available (default false)<br />
                <span class="param">speed_multiplier</span> (Optional) : The rate at which to provide the stream (supported multipliers are 1.0 and 2.0)<br />
                <span class="param">bitrate</span> (Optional) : What bitrate to stream content at, in kbps (supported bitrates are 64 and 128)<br />
                <span class="param">rtp</span> (Optional) : Whether the user is scrobbling or not during this radio session (helps content generation)<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                  <span class="param">api_sig</span> (Required) : A Last.fm method signature. See <a href="/api/authentication">authentication</a> for more information.<br />
                     <span class="param">sk</span> (Required) : A session key generated by authenticating a user via the authentication protocol.
                              <h2>Auth</h2>
                                     
                           This service requires authentication. Please see our <a href="/api/authentication">authentication</a> how-to.<br/>
                        l
            <h2>Sample Response</h2>
                                                                                                                                                                                                                                            <div id="sample">
                    <pre>&lt;playlist version=&quot;1&quot; xmlns=&quot;http://xspf.org/ns/0/&quot;&gt;
 &lt;title&gt;+Cher+Similar+Artists&lt;/title&gt;
 &lt;creator&gt;Last.fm&lt;/creator&gt;
 &lt;date&gt;2007-11-26T17:34:38&lt;/date&gt;
 &lt;link rel=&quot;http://www.last.fm/expiry&quot;&gt;3600&lt;/link&gt;
 &lt;trackList&gt;
  &lt;track&gt;
   &lt;location&gt;http://play.last.fm/ ... .mp3&lt;/location&gt;
   &lt;title&gt;Two People (Live)&lt;/title&gt;
   &lt;identifier&gt;8212510&lt;/identifier&gt;
   &lt;album&gt;Tina Live In Europe&lt;/album&gt;
   &lt;creator&gt;Tina Turner&lt;/creator&gt;
   &lt;<span class="tagDescription" title="In milliseconds">duration</span>&gt;265000&lt;/duration&gt;
   &lt;image&gt;http:// ... .jpg&lt;/image&gt;
   &lt;extension application=&quot;http://www.last.fm&quot;&gt;
     &lt;artistpage&gt;&lt;/artistpage&gt;
     &lt;albumpage&gt;...&lt;/albumpage&gt;
     &lt;trackpage&gt;...&lt;/trackpage&gt;
     &lt;buyTrackURL&gt;...&lt;/buyTrackURL&gt;
     &lt;buyAlbumURL&gt;...&lt;/buyAlbumURL&gt;
     &lt;freeTrackURL&gt;...&lt;/freeTrackURL&gt;
   &lt;/extension&gt;
  &lt;/track&gt;
   ...
 &lt;/trackList&gt;
&lt;/playlist&gt;</pre>
                                        Hover over the underlined tags and attributes to get detailed information.
                                    </div>
                                
                                    <h2>Errors</h2>
            <ul>
                                    <li><span class="param">12</span> : Subscribers Only - This station is only available to paid last.fm subscribers</li>
                                                <li><span class="param">8</span> : Operation Failed - Server Error. Please try again later.</li>
                                                <li><span class="param">18</span> : Trial Expired - This user has no free radio plays left. Subscription required</li>
                                                <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>radio.search</h1>
    <div class="wsdescription">
        Resolve the name of a resource into a station depending on which resource
it is most likely to represent
    </div>
        <p class="sampleurl">
    e.g. <a href="http://ws.audioscrobbler.com/2.0/?method=radio.search&name=radiohead&api_key=b25b959554ed76058ac220b7b2e0a026">http://ws.audioscrobbler.com/2.0/?method=radio.search&name=radiohead&api_key=b25b959554ed76058a...</a> 
    </p>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">name</span> (Required) : The tag or artist to resolve<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                     <h2>Auth</h2>
                                     
                           This service does <b>not</b> require authentication.
                        l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;lfm status=&quot;ok&quot;&gt;
    &lt;stations&gt;
        &lt;station&gt;
            &lt;name&gt;Radiohead Radio&lt;/name&gt;
            &lt;url&gt;lastfm://artist/Radiohead/similarartists&lt;/url&gt;
        &lt;/station&gt;
    &lt;/stations&gt;
&lt;/lfm&gt;</pre>
                                    </div>
                                
                                    <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>radio.tune</h1>
    <div class="wsdescription">
        Tune in to a Last.fm radio station.
    </div>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">lang</span> (Optional) : An ISO language code to determine the language to return the station name in, expressed as an ISO 639 alpha-2 code.<br />
                <span class="param">station</span> (Required) : A lastfm:// radio URL<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                  <span class="param">api_sig</span> (Required) : A Last.fm method signature. See <a href="/api/authentication">authentication</a> for more information.<br />
                     <span class="param">sk</span> (Required) : A session key generated by authenticating a user via the authentication protocol.
                              <h2>Auth</h2>
                                     
                           This service requires authentication. Please see our <a href="/api/authentication">authentication</a> how-to.<br/>
                                        This is a <b>write</b> service and must be accessed with an HTTP POST request. All parameters should be sent in the POST body, including the 'method' parameter. See <a href="/api/rest">rest requests</a> for more information.
            l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;lfm status=&quot;ok&quot;&gt;
	&lt;station&gt;
		&lt;type&gt;artist&lt;/type&gt;
		&lt;name&gt;Cher Similar Artists&lt;/name&gt;
		&lt;url&gt;http://www.last.fm/listen/artist/Cher/similarartists&lt;/url&gt;
		&lt;supportsdiscovery&gt;1&lt;/supportsdiscovery&gt;
	&lt;/station&gt;
&lt;/lfm&gt;</pre>
                                    </div>
                                
                                    <h2>Errors</h2>
            <ul>
                                    <li><span class="param">20</span> : Not Enough Content - There is not enough content to play this station</li>
                                                <li><span class="param">21</span> : Not Enough Members - This group does not have enough members for radio</li>
                                                <li><span class="param">18</span> : Trial Expired - This user has no free radio plays left. Subscription required</li>
                                                <li><span class="param">12</span> : Subscribers Only - This station is only available to paid Last.fm subscribers</li>
                                                <li><span class="param">22</span> : Not Enough Fans - This artist does not have enough fans for for radio</li>
                                                <li><span class="param">23</span> : Not Enough Neighbours - There are not enough neighbours for radio</li>
                                                <li><span class="param">28</span> : Geo Restricted - This station is not available with this client/country combination</li>
                                                <li><span class="param">27</span> : Deprecated - This station is no longer available</li>
                                                <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>tag.getInfo</h1>
    <div class="wsdescription">
        Get the metadata for a tag
    </div>
        <p class="sampleurl">
    e.g. <a href="http://ws.audioscrobbler.com/2.0/?method=tag.getinfo&tag=disco&api_key=b25b959554ed76058ac220b7b2e0a026">http://ws.audioscrobbler.com/2.0/?method=tag.getinfo&tag=disco&api_key=b25b959554ed76058ac220b7...</a> 
    </p>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">lang</span> (Optional) : The language to return the biography in, expressed as an ISO 639 alpha-2 code.<br />
                <span class="param">artist</span> (Required (unless mbid)] : The artist name<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                     <h2>Auth</h2>
                                     
                           This service does <b>not</b> require authentication.
                        l
            <h2>Sample Response</h2>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            <div id="sample">
                    <pre>&lt;tag&gt;
    &lt;name&gt;disco&lt;/name&gt;
    &lt;url&gt;http://www.last.fm/tag/disco&lt;/url&gt;
    &lt;<span class="tagDescription" title="The number of users that have used this tag">reach</span>&gt;27199&lt;/reach&gt;
    &lt;<span class="tagDescription" title="The total number of times this tag has been used">taggings</span>&gt;114210&lt;/taggings&gt;
    &lt;<span class="tagDescription" title="A value of '1' indicates this tag can be used as a radio station">streamable</span>&gt;1&lt;/streamable&gt;
    &lt;wiki&gt;
        &lt;published&gt;Thu, 19 Aug 2010 03:22:16 +0000&lt;/published&gt;
        &lt;summary&gt;&lt;![CDATA[Disco is a genre of dance-oriented music]]&gt;&lt;/summary&gt;
        &lt;content&gt;&lt;![CDATA[Disco is a genre of dance-oriented music that originated in African American, gay and Hispanic American communities in 1970s. (truncated for readability in sample)]]&gt;&lt;/content&gt;
    &lt;/wiki&gt;
&lt;/tag&gt;</pre>
                                        Hover over the underlined tags and attributes to get detailed information.
                                    </div>
                                
                                    <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>tag.getSimilar</h1>
    <div class="wsdescription">
        Search for tags similar to this one. Returns tags ranked by similarity,
based on listening data.
    </div>
        <p class="sampleurl">
    e.g. <a href="http://ws.audioscrobbler.com/2.0/?method=tag.getsimilar&tag=disco&api_key=b25b959554ed76058ac220b7b2e0a026">http://ws.audioscrobbler.com/2.0/?method=tag.getsimilar&tag=disco&api_key=b25b959554ed76058ac22...</a> 
    </p>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">tag</span> (Required) : The tag name<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                     <h2>Auth</h2>
                                     
                           This service does <b>not</b> require authentication.
                        l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;similartags tag=&quot;Disco&quot;&gt;
  &lt;tag&gt;
    &lt;name&gt;high energy&lt;/name&gt;
    &lt;url&gt;http://www.last.fm/tag/high energy&lt;/url&gt;
    &lt;streamable&gt;1&lt;/streamable&gt;
  &lt;/tag&gt;
  ...
&lt;/similartags&gt;</pre>
                                    </div>
                                
                                    <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>tag.getTopAlbums</h1>
    <div class="wsdescription">
        Get the top albums tagged by this tag, ordered by tag count.
    </div>
        <p class="sampleurl">
    e.g. <a href="http://ws.audioscrobbler.com/2.0/?method=tag.gettopalbums&tag=disco&api_key=b25b959554ed76058ac220b7b2e0a026">http://ws.audioscrobbler.com/2.0/?method=tag.gettopalbums&tag=disco&api_key=b25b959554ed76058ac...</a> 
    </p>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">tag</span> (Required) : The tag name<br />
                <span class="param">limit</span> (Optional) : The number of results to fetch per page. Defaults to 50.<br />
                <span class="param">page</span> (Optional) : The page number to fetch.  Defaults to first page.<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                     <h2>Auth</h2>
                                     
                           This service does <b>not</b> require authentication.
                        l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;topalbums tag=&quot;Disco&quot;&gt;
  &lt;album rank=&quot;&quot;&gt;
    &lt;name&gt;Overpowered&lt;/name&gt;
    &lt;mbid/&gt;
    &lt;url&gt;
      http://www.last.fm/music/Róisín+Murphy/Overpowered
    &lt;/url&gt;
    &lt;artist&gt;
      &lt;name&gt;Róisín Murphy&lt;/name&gt;
      &lt;mbid&gt;4c56405d-ba8e-4283-99c3-1dc95bdd50e7&lt;/mbid&gt;
      &lt;url&gt;http://www.last.fm/music/Róisín+Murphy&lt;/url&gt;
    &lt;/artist&gt;
    &lt;image size=&quot;small&quot;&gt;...&lt;/image&gt;
    &lt;image size=&quot;medium&quot;&gt;...&lt;/image&gt;
    &lt;image size=&quot;large&quot;&gt;...&lt;/image&gt;
  &lt;/album&gt;
  ...
&lt;/topalbums&gt;</pre>
                                    </div>
                                
                                    <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>tag.getTopArtists</h1>
    <div class="wsdescription">
        Get the top artists tagged by this tag, ordered by tag count.
    </div>
        <p class="sampleurl">
    e.g. <a href="http://ws.audioscrobbler.com/2.0/?method=tag.gettopartists&tag=disco&api_key=b25b959554ed76058ac220b7b2e0a026">http://ws.audioscrobbler.com/2.0/?method=tag.gettopartists&tag=disco&api_key=b25b959554ed76058a...</a> 
    </p>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">tag</span> (Required) : The tag name<br />
                <span class="param">limit</span> (Optional) : The number of results to fetch per page. Defaults to 50.<br />
                <span class="param">page</span> (Optional) : The page number to fetch.  Defaults to first page.<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                     <h2>Auth</h2>
                                     
                           This service does <b>not</b> require authentication.
                        l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;topartists tag=&quot;Disco&quot;&gt;
  &lt;artist rank=&quot;&quot;&gt;
    &lt;name&gt;ABBA&lt;/name&gt;
    &lt;mbid&gt;d87e52c5-bb8d-4da8-b941-9f4928627dc8&lt;/mbid&gt;
    &lt;url&gt;http://www.last.fm/music/ABBA&lt;/url&gt;
    &lt;streamable&gt;1&lt;/streamable&gt;
    &lt;image size=&quot;small&quot;&gt;...&lt;/image&gt;
    &lt;image size=&quot;medium&quot;&gt;...&lt;/image&gt;
    &lt;image size=&quot;large&quot;&gt;...&lt;/image&gt;
  &lt;/artist&gt;
  ...
&lt;/topartists&gt;</pre>
                                    </div>
                                
                                    <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>tag.getTopTags</h1>
    <div class="wsdescription">
        Fetches the top global tags on Last.fm, sorted by popularity (number of
times used)
    </div>
        <p class="sampleurl">
    e.g. <a href="http://ws.audioscrobbler.com/2.0/?method=tag.getTopTags&api_key=b25b959554ed76058ac220b7b2e0a026">http://ws.audioscrobbler.com/2.0/?method=tag.getTopTags&api_key=b25b959554ed76058ac220b7b2e0a026</a> 
    </p>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param"></span>  <br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                     <h2>Auth</h2>
                                     
                           This service does <b>not</b> require authentication.
                        l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;toptags&gt;
  &lt;tag&gt;
    &lt;name&gt;rock&lt;/name&gt;
    &lt;count&gt;1994155&lt;/count&gt;
    &lt;url&gt;www.last.fm/tag/rock&lt;/url&gt;
  &lt;/tag&gt;
  ...
&lt;/toptags&gt;</pre>
                                    </div>
                                
                                    <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>tag.getTopTracks</h1>
    <div class="wsdescription">
        Get the top tracks tagged by this tag, ordered by tag count.
    </div>
        <p class="sampleurl">
    e.g. <a href="http://ws.audioscrobbler.com/2.0/?method=tag.gettoptracks&tag=disco&api_key=b25b959554ed76058ac220b7b2e0a026">http://ws.audioscrobbler.com/2.0/?method=tag.gettoptracks&tag=disco&api_key=b25b959554ed76058ac...</a> 
    </p>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">tag</span> (Required) : The tag name<br />
                <span class="param">limit</span> (Optional) : The number of results to fetch per page. Defaults to 50.<br />
                <span class="param">page</span> (Optional) : The page number to fetch.  Defaults to first page.<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                     <h2>Auth</h2>
                                     
                           This service does <b>not</b> require authentication.
                        l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;toptracks tag=&quot;Disco&quot;&gt;
  &lt;track rank=&quot;&quot;&gt;
    &lt;name&gt;Stayin' Alive&lt;/name&gt;
    &lt;mbid/&gt;
    &lt;url&gt;
      http://www.last.fm/music/Bee+Gees/_/Stayin'+Alive
    &lt;/url&gt;
    &lt;streamable fulltrack=&quot;0&quot;&gt;1&lt;/streamable&gt;
    &lt;artist&gt;
      &lt;name&gt;Bee Gees&lt;/name&gt;
      &lt;mbid&gt;bf0f7e29-dfe1-416c-b5c6-f9ebc19ea810&lt;/mbid&gt;
      &lt;url&gt;http://www.last.fm/music/Bee+Gees&lt;/url&gt;
    &lt;/artist&gt;
    &lt;image size=&quot;small&quot;&gt;...&lt;/image&gt;
    &lt;image size=&quot;medium&quot;&gt;...&lt;/image&gt;
    &lt;image size=&quot;large&quot;&gt;...&lt;/image&gt;
  &lt;/track&gt;
  ...
&lt;/toptracks&gt;</pre>
                                    </div>
                                
                                    <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>tag.getWeeklyArtistChart</h1>
    <div class="wsdescription">
        Get an artist chart for a tag, for a given date range. If no date range is
supplied, it will return the most recent artist chart for this tag.
    </div>
        <p class="sampleurl">
    e.g. <a href="http://ws.audioscrobbler.com/2.0/?method=tag.getweeklyartistchart&tag=disco&api_key=b25b959554ed76058ac220b7b2e0a026">http://ws.audioscrobbler.com/2.0/?method=tag.getweeklyartistchart&tag=disco&api_key=b25b959554e...</a> 
    </p>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">tag</span> (Required) : The tag name<br />
                <span class="param">from</span> (Optional) : The date at which the chart should start from. See Tag.getWeeklyChartList for more.<br />
                <span class="param">to</span> (Optional) : The date at which the chart should end on. See Tag.getWeeklyChartList for more.<br />
                <span class="param">limit</span> (Optional) : The number of results to fetch per page. Defaults to 50.<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                     <h2>Auth</h2>
                                     
                           This service does <b>not</b> require authentication.
                        l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;weeklyartistchart tag=&quot;rock&quot; from=&quot;1220788800&quot; to=&quot;1221393600&quot;&gt;
  &lt;artist rank=&quot;1&quot;&gt;
    &lt;name&gt;Coldplay&lt;/name&gt;
    &lt;mbid&gt;cc197bad-dc9c-440d-a5b5-d52ba2e14234&lt;/mbid&gt;
    &lt;weight&gt;1351069952&lt;/weight&gt;
    &lt;url&gt;http://www.last.fm/music/Coldplay&lt;/url&gt;
  &lt;/artist&gt;
  ...
&lt;/weeklyartistchart&gt;</pre>
                                    </div>
                                
                                    <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>tag.getWeeklyChartList</h1>
    <div class="wsdescription">
        Get a list of available charts for this tag, expressed as date ranges which
can be sent to the chart services.
    </div>
        <p class="sampleurl">
    e.g. <a href="http://ws.audioscrobbler.com/2.0/?method=tag.getweeklychartlist&tag=disco&api_key=b25b959554ed76058ac220b7b2e0a026">http://ws.audioscrobbler.com/2.0/?method=tag.getweeklychartlist&tag=disco&api_key=b25b959554ed7...</a> 
    </p>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">tag</span> (Required) : The tag name<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                     <h2>Auth</h2>
                                     
                           This service does <b>not</b> require authentication.
                        l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;weeklychartlist tag=&quot;rock&quot;&gt;
  &lt;chart from=&quot;1108296002&quot; to=&quot;1108900802&quot;/&gt;
  &lt;chart from=&quot;1108900801&quot; to=&quot;1109505601&quot;/&gt;
  ...
&lt;/weeklychartlist&gt;</pre>
                                    </div>
                                
                                    <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>tag.search</h1>
    <div class="wsdescription">
        Search for a tag by name. Returns matches sorted by relevance.
    </div>
        <p class="sampleurl">
    e.g. <a href="http://ws.audioscrobbler.com/2.0/?method=tag.search&tag=disco&api_key=b25b959554ed76058ac220b7b2e0a026">http://ws.audioscrobbler.com/2.0/?method=tag.search&tag=disco&api_key=b25b959554ed76058ac220b7b...</a> 
    </p>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">limit</span> (Optional) : The number of results to fetch per page. Defaults to 30.<br />
                <span class="param">page</span> (Optional) : The page number to fetch.  Defaults to first page.<br />
                <span class="param">tag</span> (Required) : The tag name<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                     <h2>Auth</h2>
                                     
                           This service does <b>not</b> require authentication.
                        l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;results for=&quot;disco&quot; xmlns:opensearch=&quot;http://a9.com/-/spec/opensearch/1.1/&quot;&gt;
  &lt;opensearch:Query role=&quot;request&quot; searchTerms=&quot;disco&quot; startPage=&quot;1&quot;/&gt;
  &lt;opensearch:totalResults&gt;2097&lt;/opensearch:totalResults&gt;
  &lt;opensearch:startIndex&gt;0&lt;/opensearch:startIndex&gt;
  &lt;opensearch:itemsPerPage&gt;20&lt;/opensearch:itemsPerPage&gt;
  &lt;tagmatches&gt;
    &lt;tag&gt;
      &lt;name&gt;disco&lt;/name&gt;
      &lt;url&gt;www.last.fm/tag/disco&lt;/url&gt;
    &lt;/tag&gt;
    ...
  &lt;/tagmatches&gt;
&lt;/results&gt;</pre>
                                    </div>
                                
                                    <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>tasteometer.compare</h1>
    <div class="wsdescription">
        Get a Tasteometer score from two inputs, along with a list of shared
artists. If the input is a User some additional information is returned.
    </div>
        <p class="sampleurl">
    e.g. <a href="http://ws.audioscrobbler.com/2.0/?method=tasteometer.compare&type1=user&type2=user&value1=joanofarctan&value2=mirandason&api_key=b25b959554ed76058ac220b7b2e0a026">http://ws.audioscrobbler.com/2.0/?method=tasteometer.compare&type1=user&type2=user&value1=joano...</a> 
    </p>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">type[1|2]</span> (Required x 2) : 'user' | 'artists'<br />
                <span class="param">value[1|2]</span> (Required x 2) : [Last.fm username] | [Comma-separated artist names (max. 100)]<br />
                <span class="param">limit</span> (Optional, default = 5) : How many shared artists to display<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                     <h2>Auth</h2>
                                     
                           This service does <b>not</b> require authentication.
                        l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;lfm status=&quot;ok&quot;&gt;
    &lt;comparison&gt;
        &lt;result&gt;
            &lt;score&gt;0.74&lt;/score&gt;
            &lt;artists matches=&quot;43&quot;&gt;
                &lt;artist&gt;
                    &lt;name&gt;Radiohead&lt;/name&gt;
                    &lt;url&gt;http://www.last.fm/music/Radiohead&lt;/url&gt;
                    &lt;image size=&quot;large&quot;&gt;http://userserve-ak.last.fm/serve/160/169665.gif&lt;/image&gt;
                    &lt;image size=&quot;medium&quot;&gt;http://userserve-ak.last.fm/serve/85/169665.gif&lt;/image&gt;
                    &lt;image size=&quot;small&quot;&gt;http://userserve-ak.last.fm/serve/50/169665.gif&lt;/image&gt;
                &lt;/artist&gt;
                &lt;artist&gt;
                    &lt;name&gt;The Beatles&lt;/name&gt;
                    &lt;url&gt;http://www.last.fm/music/The+Beatles&lt;/url&gt;
                    &lt;image size=&quot;large&quot;&gt;http://userserve-ak.last.fm/serve/160/153358.jpg&lt;/image&gt;
                    &lt;image size=&quot;medium&quot;&gt;http://userserve-ak.last.fm/serve/85/153358.jpg&lt;/image&gt;
                    &lt;image size=&quot;small&quot;&gt;http://userserve-ak.last.fm/serve/50/153358.jpg&lt;/image&gt;
                &lt;/artist&gt;
            &lt;/artists&gt;
        &lt;/result&gt;
        &lt;input&gt;
            &lt;user&gt;
                &lt;name&gt;jwheare&lt;/name&gt;
                &lt;url&gt;http://www.last.fm/user/jwheare/&lt;/url&gt;
                &lt;image size=&quot;large&quot;&gt;http://userserve-ak.last.fm/serve/160/857567.png&lt;/image&gt;
                &lt;image size=&quot;medium&quot;&gt;http://userserve-ak.last.fm/serve/85/857567.png&lt;/image&gt;
                &lt;image size=&quot;small&quot;&gt;http://userserve-ak.last.fm/serve/50/857567.png&lt;/image&gt;
            &lt;/user&gt;
            &lt;myspace&gt;
                &lt;url&gt;http://www.myspace.com/mcscrobbler&lt;/url&gt;
                &lt;image&gt;http://x.myspace.com/images/clear.gif&lt;/image&gt;
            &lt;/myspace&gt;
        &lt;/input&gt;
    &lt;/comparison&gt;
&lt;/lfm&gt;</pre>
                                    </div>
                                
                                    <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>tasteometer.compareGroup</h1>
    <div class="wsdescription">
        This service has been deprecated and is no longer available.
    </div>
        <p class="sampleurl">
    e.g. <a href="http://ws.audioscrobbler.com/2.0/?method=tasteometer.comparegroup&api_key=b25b959554ed76058ac220b7b2e0a026">http://ws.audioscrobbler.com/2.0/?method=tasteometer.comparegroup&api_key=b25b959554ed76058ac22...</a> 
    </p>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param"></span>  <br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                     <h2>Auth</h2>
                                     
                           This service does <b>not</b> require authentication.
                        l
            <h2>Sample Response</h2>
                                
                                    <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>track.addTags</h1>
    <div class="wsdescription">
        Tag an album using a list of user supplied tags.
    </div>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">artist</span> (Required) : The artist name<br />
                <span class="param">track</span> (Required) : The track name<br />
                <span class="param">tags</span> (Required) : A comma delimited list of user supplied tags to apply to this track. Accepts a maximum of 10 tags.<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                  <span class="param">api_sig</span> (Required) : A Last.fm method signature. See <a href="/api/authentication">authentication</a> for more information.<br />
                     <span class="param">sk</span> (Required) : A session key generated by authenticating a user via the authentication protocol.
                              <h2>Auth</h2>
                                     
                           This service requires authentication. Please see our <a href="/api/authentication">authentication</a> how-to.<br/>
                                        This is a <b>write</b> service and must be accessed with an HTTP POST request. All parameters should be sent in the POST body, including the 'method' parameter. See <a href="/api/rest">rest requests</a> for more information.
            l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;lfm status=&quot;ok&quot;&gt;
&lt;/lfm&gt;</pre>
                                    </div>
                                
                                    <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>track.ban</h1>
    <div class="wsdescription">
        Ban a track for a given user profile.
    </div>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">track</span> (Required) : A track name (utf8 encoded)<br />
                <span class="param">artist</span> (Required) : An artist name (utf8 encoded)<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                  <span class="param">api_sig</span> (Required) : A Last.fm method signature. See <a href="/api/authentication">authentication</a> for more information.<br />
                     <span class="param">sk</span> (Required) : A session key generated by authenticating a user via the authentication protocol.
                              <h2>Auth</h2>
                                     
                           This service requires authentication. Please see our <a href="/api/authentication">authentication</a> how-to.<br/>
                                        This is a <b>write</b> service and must be accessed with an HTTP POST request. All parameters should be sent in the POST body, including the 'method' parameter. See <a href="/api/rest">rest requests</a> for more information.
            l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;lfm status=&quot;ok&quot;&gt;
&lt;/lfm&gt;</pre>
                                    </div>
                                
                                    <h2>Errors</h2>
            <ul>
                                    <li><span class="param">8</span> : Operation Failed - Server Error. Please try again later.</li>
                                                <li><span class="param">6</span> : Invalid track name supplied</li>
                                                <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>track.getBuylinks</h1>
    <div class="wsdescription">
        Get a list of Buy Links for a particular Track.  It is required that you
supply either the artist and track params or the mbid param.
    </div>
        <p class="sampleurl">
    e.g. <a href="http://ws.audioscrobbler.com/2.0/?method=track.getbuylinks&artist=radiohead&track=creep&country=united%20kingdom&api_key=b25b959554ed76058ac220b7b2e0a026">http://ws.audioscrobbler.com/2.0/?method=track.getbuylinks&artist=radiohead&track=creep&country...</a> 
    </p>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">artist</span> (Required (unless mbid)] : The artist name<br />
                <span class="param">track</span> (Required (unless mbid)] : The track name<br />
                <span class="param">mbid</span> (Optional) : The musicbrainz id for the track<br />
                <span class="param">autocorrect[0|1]</span> (Optional) : Transform misspelled artist and track names into correct artist and track names, returning the correct version instead.  The corrected artist and track name will be returned in the response.<br />
                <span class="param">country</span> (Optional) : A country name, as defined by the ISO 3166-1 country names standard.<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                     <h2>Auth</h2>
                                     
                           This service does <b>not</b> require authentication.
                        l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;?xml version=&quot;1.0&quot; encoding=&quot;utf-8&quot;?&gt;
    &lt;lfm status=&quot;ok&quot;&gt;
        &lt;affiliations&gt;
            &lt;physicals&gt;
                &lt;affiliation&gt;
                    &lt;supplierName&gt;Amazon&lt;/supplierName&gt;
                    &lt;buyLink&gt;http://www.last.fm/affiliate/byid/9/1000343/1/ws.track.buylinks.b25b959554ed76058ac220b7b2e0a026&lt;/buyLink&gt;
                    &lt;supplierIcon&gt;http://cdn.last.fm/favicons/amazon.gif&lt;/supplierIcon&gt;
                    &lt;isSearch&gt;1&lt;/isSearch&gt;
                &lt;/affiliation&gt;
                ...
            &lt;/physicals&gt;
            &lt;downloads&gt;
                &lt;affiliation&gt;
                    &lt;supplierName&gt;7digital&lt;/supplierName&gt;
                    &lt;buyLink&gt;http://www.last.fm/affiliate/byid/9/1000343/13/ws.track.buylinks.b25b959554ed76058ac220b7b2e0a026&lt;/buyLink&gt;
                    &lt;supplierIcon&gt;http://cdn.last.fm/favicons/7digital.gif&lt;/supplierIcon&gt;
                    &lt;isSearch&gt;1&lt;/isSearch&gt;
                &lt;/affiliation&gt;
            &lt;/downloads&gt;
            ...
        &lt;/affiliations&gt;
    &lt;/lfm&gt;</pre>
                                    </div>
                                
                                    <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>track.getCorrection</h1>
    <div class="wsdescription">
        Use the last.fm corrections data to check whether the supplied track has a
correction to a canonical track
    </div>
        <p class="sampleurl">
    e.g. <a href="http://ws.audioscrobbler.com/2.0/?method=track.getcorrection&artist=guns and roses&track=Mrbrownstone&api_key=b25b959554ed76058ac220b7b2e0a026">http://ws.audioscrobbler.com/2.0/?method=track.getcorrection&artist=guns and...</a> 
    </p>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">artist</span> (Required) : The artist name to correct.<br />
                <span class="param">track</span> (Required) : The track name to  correct.<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                     <h2>Auth</h2>
                                     
                           This service does <b>not</b> require authentication.
                        l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;corrections&gt;
  &lt;correction index=&quot;0&quot; artistcorrected=&quot;1&quot; trackcorrected=&quot;1&quot;&gt;
    &lt;track&gt;
      &lt;name&gt;Mr. Brownstone&lt;/name&gt;
      &lt;mbid/&gt;
      &lt;url&gt;www.last.fm/music/Guns+N%27+Roses/_/Mr.+Brownstone&lt;/url&gt;
      &lt;artist&gt;
        &lt;name&gt;Guns N' Roses&lt;/name&gt;
        &lt;mbid&gt;eeb1195b-f213-4ce1-b28c-8565211f8e43&lt;/mbid&gt;
        &lt;url&gt;http://www.last.fm/music/Guns+N%27+Roses&lt;/url&gt;
      &lt;/artist&gt;
    &lt;/track&gt;
  &lt;/correction&gt;
&lt;/corrections&gt;</pre>
                                    </div>
                                
                                    <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>track.getFingerprintMetadata</h1>
    <div class="wsdescription">
        Retrieve track metadata associated with a fingerprint id generated by the
<a href="http://github.com/lastfm/Fingerprinter">Last.fm
Fingerprinter</a>.  Returns track elements, along with a
'rank' value between 0 and 1 reflecting the confidence for each
match. See <a
href="http://blog.last.fm/2010/07/09/fingerprint-api-and-app-updated">this
blog post</a> for more info.
    </div>
        <p class="sampleurl">
    e.g. <a href="http://ws.audioscrobbler.com/2.0/?method=track.getfingerprintmetadata&fingerprintid=1234&api_key=b25b959554ed76058ac220b7b2e0a026">http://ws.audioscrobbler.com/2.0/?method=track.getfingerprintmetadata&fingerprintid=1234&api_ke...</a> 
    </p>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">fingerprintid</span> (Required) : The fingerprint id to look up<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                     <h2>Auth</h2>
                                     
                           This service does <b>not</b> require authentication.
                        l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;tracks&gt;
  &lt;track rank=&quot;1&quot;&gt;
  &lt;name&gt;Merlin's Will&lt;/name&gt;
  &lt;mbid/&gt;
  &lt;url&gt;http://www.last.fm/music/Ayreon/_/Merlin%27s+Will&lt;/url&gt;
  &lt;streamable fulltrack=&quot;0&quot;&gt;1&lt;/streamable&gt;
  &lt;artist&gt;
    &lt;name&gt;Ayreon&lt;/name&gt;
    &lt;mbid&gt;7bbfd77c-1102-4831-9ba8-246fb67460b3&lt;/mbid&gt;
    &lt;url&gt;http://www.last.fm/music/Ayreon&lt;/url&gt;
  &lt;/artist&gt;
  &lt;image size=&quot;small&quot;&gt;http://userserve-ak.last.fm/serve/34s/38924161.png&lt;/image&gt;
  &lt;image size=&quot;medium&quot;&gt;http://userserve-ak.last.fm/serve/64s/38924161.png&lt;/image&gt;
  &lt;image size=&quot;large&quot;&gt;http://userserve-ak.last.fm/serve/126/38924161.png&lt;/image&gt;
  &lt;image size=&quot;extralarge&quot;&gt;http://userserve-ak.last.fm/serve/300x300/38924161.png&lt;/image&gt;
  &lt;/track&gt;
  ...
&lt;/tracks&gt;</pre>
                                    </div>
                                
                                    <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>track.getInfo</h1>
    <div class="wsdescription">
        Get the metadata for a track on Last.fm using the artist/track name or a
musicbrainz id.
    </div>
        <p class="sampleurl">
    e.g. <a href="http://ws.audioscrobbler.com/2.0/?method=track.getInfo&api_key=b25b959554ed76058ac220b7b2e0a026&artist=cher&track=believe">http://ws.audioscrobbler.com/2.0/?method=track.getInfo&api_key=b25b959554ed76058ac220b7b2e0a026...</a> 
    </p>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">mbid</span> (Optional) : The musicbrainz id for the track<br />
                <span class="param">track</span> (Required (unless mbid)] : The track name<br />
                <span class="param">artist</span> (Required (unless mbid)] : The artist name<br />
                <span class="param">username</span> (Optional) : The username for the context of the request. If supplied, the user's playcount for this track and whether they have loved the track is included in the response.<br />
                <span class="param">autocorrect[0|1]</span> (Optional) : Transform misspelled artist and track names into correct artist and track names, returning the correct version instead.  The corrected artist and track name will be returned in the response.<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                     <h2>Auth</h2>
                                     
                           This service does <b>not</b> require authentication.
                        l
            <h2>Sample Response</h2>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            <div id="sample">
                    <pre>&lt;track&gt;
  &lt;id&gt;1019817&lt;/id&gt;
  &lt;name&gt;Believe&lt;/name&gt;
  &lt;mbid/&gt;
  &lt;url&gt;http://www.last.fm/music/Cher/_/Believe&lt;/url&gt;
  &lt;<span class="tagDescription" title="In milliseconds">duration</span>&gt;240000&lt;/duration&gt;
  &lt;<span class="tagDescription" title="A tag value of 1 indicates a 30 second preview of this song is available for streaming">streamable</span> <span class="tagDescription" title="An attribute value of 1 indicates a full length preview is available for streaming">fulltrack</span>=&quot;1&quot;&gt;1&lt;/streamable&gt;
  &lt;listeners&gt;69572&lt;/listeners&gt;
  &lt;playcount&gt;281445&lt;/playcount&gt;
  &lt;artist&gt;
    &lt;name&gt;Cher&lt;/name&gt;
    &lt;mbid&gt;bfcc6d75-a6a5-4bc6-8282-47aec8531818&lt;/mbid&gt;
    &lt;url&gt;http://www.last.fm/music/Cher&lt;/url&gt;
  &lt;/artist&gt;
  &lt;album position=&quot;1&quot;&gt;
    &lt;artist&gt;Cher&lt;/artist&gt;
    &lt;title&gt;Believe&lt;/title&gt;
    &lt;mbid&gt;61bf0388-b8a9-48f4-81d1-7eb02706dfb0&lt;/mbid&gt;
    &lt;url&gt;http://www.last.fm/music/Cher/Believe&lt;/url&gt;
    &lt;image size=&quot;small&quot;&gt;http://userserve-ak.last.fm/serve/34/8674593.jpg&lt;/image&gt;
    &lt;image size=&quot;medium&quot;&gt;http://userserve-ak.last.fm/serve/64/8674593.jpg&lt;/image&gt;
    &lt;image size=&quot;large&quot;&gt;http://userserve-ak.last.fm/serve/126/8674593.jpg&lt;/image&gt;
  &lt;/album&gt;
  &lt;toptags&gt;
    &lt;tag&gt;
      &lt;name&gt;pop&lt;/name&gt;
      &lt;url&gt;http://www.last.fm/tag/pop&lt;/url&gt;
    &lt;/tag&gt;
    ...
  &lt;/toptags&gt;
  &lt;wiki&gt;
    &lt;published&gt;Sun, 27 Jul 2008 15:44:58 +0000&lt;/published&gt;
    &lt;summary&gt;...&lt;/summary&gt;
    &lt;content&gt;...&lt;/content&gt;
  &lt;/wiki&gt;
&lt;/track&gt;</pre>
                                        Hover over the underlined tags and attributes to get detailed information.
                                    </div>
                                
                                    <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>track.getShouts</h1>
    <div class="wsdescription">
        Get shouts for this track. Also available as an rss feed.
    </div>
        <p class="sampleurl">
    e.g. <a href="http://ws.audioscrobbler.com/2.0/?method=track.getshouts&artist=cher&track=believe&api_key=b25b959554ed76058ac220b7b2e0a026">http://ws.audioscrobbler.com/2.0/?method=track.getshouts&artist=cher&track=believe&api_key=b25b...</a> 
    </p>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">track</span> (Required (unless mbid)] : The track name<br />
                <span class="param">artist</span> (Required (unless mbid)] : The artist name<br />
                <span class="param">mbid</span> (Optional) : The musicbrainz id for the track<br />
                <span class="param">limit</span> (Optional) : The number of results to fetch per page. Defaults to 50.<br />
                <span class="param">autocorrect[0|1]</span> (Optional) : Transform misspelled artist and track names into correct artist and track names, returning the correct version instead.  The corrected artist and track name will be returned in the response.<br />
                <span class="param">page</span> (Optional) : The page number to fetch.  Defaults to first page.<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                     <h2>Auth</h2>
                                     
                           This service does <b>not</b> require authentication.
                        l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;shouts artist=&quot;Cher&quot; track=&quot;Believe&quot; total=&quot;458&quot; page=&quot;1&quot; perPage=&quot;50&quot; totalPages=&quot;10&quot;&gt;
  &lt;shout&gt;
    &lt;body&gt;I am her biggest fan&lt;/body&gt;
    &lt;author&gt;joanofarctan&lt;/author&gt;
    &lt;date&gt;Wed, 27 Oct 2010 14:10:03&lt;/date&gt;
  &lt;/shout&gt;
  ...
&lt;/shouts&gt;</pre>
                                    </div>
                                
                    <h2>Other Formats</h2>
                            Also available as a feed in <b>rss</b> format                <p>
                                    e.g. <a href="http://ws.audioscrobbler.com/2.0/track/shouts.rss">http://ws.audioscrobbler.com/2.0/track/shouts.rss</a><br />
                                </p>
                                                <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>track.getSimilar</h1>
    <div class="wsdescription">
        Get the similar tracks for this track on Last.fm, based on listening data.
    </div>
        <p class="sampleurl">
    e.g. <a href="http://ws.audioscrobbler.com/2.0/?method=track.getsimilar&artist=cher&track=believe&api_key=b25b959554ed76058ac220b7b2e0a026">http://ws.audioscrobbler.com/2.0/?method=track.getsimilar&artist=cher&track=believe&api_key=b25...</a> 
    </p>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">track</span> (Required (unless mbid)] : The track name<br />
                <span class="param">artist</span> (Required (unless mbid)] : The artist name<br />
                <span class="param">mbid</span> (Optional) : The musicbrainz id for the track<br />
                <span class="param">autocorrect[0|1]</span> (Optional) : Transform misspelled artist and track names into correct artist and track names, returning the correct version instead.  The corrected artist and track name will be returned in the response.<br />
                <span class="param">limit</span> (Optional) : Maximum number of similar tracks to return<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                     <h2>Auth</h2>
                                     
                           This service does <b>not</b> require authentication.
                        l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;similartracks track=&quot;Believe&quot; artist=&quot;Cher&quot;&gt;
  &lt;track&gt;
    &lt;name&gt;Ray of Light&lt;/name&gt;
    &lt;mbid/&gt;
    &lt;match&gt;10.95&lt;/match&gt;
    &lt;url&gt;http://www.last.fm/music/Madonna/_/Ray+of+Light&lt;/url&gt;
    &lt;streamable fulltrack=&quot;0&quot;&gt;1&lt;/streamable&gt;
    &lt;artist&gt;
      &lt;name&gt;Madonna&lt;/name&gt;
      &lt;mbid&gt;79239441-bfd5-4981-a70c-55c3f15c1287&lt;/mbid&gt;
      &lt;url&gt;http://www.last.fm/music/Madonna&lt;/url&gt;
    &lt;/artist&gt;
    &lt;image size=&quot;small&quot;&gt;http://cdn.last.fm/coverart/50x50/1934.jpg&lt;/image&gt;
    &lt;image size=&quot;medium&quot;&gt;http://cdn.last.fm/coverart/130x130/1934.jpg&lt;/image&gt;
    &lt;image size=&quot;large&quot;&gt;http://cdn.last.fm/coverart/130x130/1934.jpg&lt;/image&gt;
  &lt;/track&gt;
  ...
&lt;/similartracks&gt;</pre>
                                    </div>
                                
                                    <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>track.getTags</h1>
    <div class="wsdescription">
        Get the tags applied by an individual user to a track on Last.fm. To
retrieve the list of top tags applied to a track by all users use
track.getTopTags.
    </div>
        <p class="sampleurl">
    e.g. <a href="http://ws.audioscrobbler.com/2.0/?method=track.getTags&api_key=b25b959554ed76058ac220b7b2e0a026&artist=AC/DC&track=Hells+Bells&user=RJ">http://ws.audioscrobbler.com/2.0/?method=track.getTags&api_key=b25b959554ed76058ac220b7b2e0a026...</a> 
    </p>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">artist</span> (Required (unless mbid)] : The artist name<br />
                <span class="param">track</span> (Required (unless mbid)] : The track name<br />
                <span class="param">mbid</span> (Optional) : The musicbrainz id for the track<br />
                <span class="param">autocorrect[0|1]</span> (Optional) : Transform misspelled artist and track names into correct artist and track names, returning the correct version instead.  The corrected artist and track name will be returned in the response.<br />
                <span class="param">user</span> (Optional) : If called in non-authenticated mode you must specify the user to look up<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                     <h2>Auth</h2>
                                     
                           This service does <b>not</b> require authentication.
                        l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;tags artist=&quot;Sally Shapiro&quot; track=&quot;I'll be by your side&quot;&gt;
  &lt;tag&gt;
    &lt;name&gt;swedish&lt;/name&gt;
    &lt;url&gt;http://www.last.fm/tag/swedish&lt;/url&gt;
  &lt;/tag&gt;
  ...
&lt;/tags&gt;</pre>
                                    </div>
                                
                                    <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>track.getTopFans</h1>
    <div class="wsdescription">
        Get the top fans for this track on Last.fm, based on listening data. Supply
either track & artist name or musicbrainz id.
    </div>
        <p class="sampleurl">
    e.g. <a href="http://ws.audioscrobbler.com/2.0/?method=track.gettopfans&artist=cher&track=believe&api_key=b25b959554ed76058ac220b7b2e0a026">http://ws.audioscrobbler.com/2.0/?method=track.gettopfans&artist=cher&track=believe&api_key=b25...</a> 
    </p>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">track</span> (Required (unless mbid)] : The track name<br />
                <span class="param">artist</span> (Required (unless mbid)] : The artist name<br />
                <span class="param">mbid</span> (Optional) : The musicbrainz id for the track<br />
                <span class="param">autocorrect[0|1]</span> (Optional) : Transform misspelled artist and track names into correct artist and track names, returning the correct version instead.  The corrected artist and track name will be returned in the response.<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                     <h2>Auth</h2>
                                     
                           This service does <b>not</b> require authentication.
                        l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;topfans artist=&quot;Cher&quot; track=&quot;Believe&quot;&gt;
  &lt;user&gt;
    &lt;name&gt;snevekat&lt;/name&gt;
    &lt;url&gt;http://www.last.fm/user/snevekat/&lt;/url&gt;
    &lt;image size=&quot;small&quot;&gt;http://userserve-ak.last.fm/serve/50/1599285.jpg&lt;/image&gt;
    &lt;image size=&quot;medium&quot;&gt;http://userserve-ak.last.fm/serve/85/1599285.jpg&lt;/image&gt;
    &lt;image size=&quot;large&quot;&gt;http://userserve-ak.last.fm/serve/160/1599285.jpg&lt;/image&gt;
    &lt;weight&gt;1000000&lt;/weight&gt;
  &lt;/user&gt;
  ...
&lt;/topfans&gt;</pre>
                                    </div>
                                
                                    <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>track.getTopTags</h1>
    <div class="wsdescription">
        Get the top tags for this track on Last.fm, ordered by tag count. Supply
either track & artist name or mbid.
    </div>
        <p class="sampleurl">
    e.g. <a href="http://ws.audioscrobbler.com/2.0/?method=track.gettoptags&artist=radiohead&track=paranoid+android&api_key=b25b959554ed76058ac220b7b2e0a026">http://ws.audioscrobbler.com/2.0/?method=track.gettoptags&artist=radiohead&track=paranoid+andro...</a> 
    </p>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">track</span> (Required (unless mbid)] : The track name<br />
                <span class="param">artist</span> (Required (unless mbid)] : The artist name<br />
                <span class="param">mbid</span> (Optional) : The musicbrainz id for the track<br />
                <span class="param">autocorrect[0|1]</span> (Optional) : Transform misspelled artist and track names into correct artist and track names, returning the correct version instead.  The corrected artist and track name will be returned in the response.<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                     <h2>Auth</h2>
                                     
                           This service does <b>not</b> require authentication.
                        l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;toptags artist=&quot;Cher&quot; track=&quot;Believe&quot;&gt;
  &lt;tag&gt;
    &lt;name&gt;pop&lt;/name&gt;
    &lt;count&gt;97&lt;/count&gt;
    &lt;url&gt;www.last.fm/tag/pop&lt;/url&gt;
  &lt;/tag&gt;
  &lt;tag&gt;
    &lt;name&gt;dance&lt;/name&gt;
    &lt;count&gt;88&lt;/count&gt;
    &lt;url&gt;www.last.fm/tag/dance&lt;/url&gt;
  &lt;/tag&gt;
  ...
&lt;/toptags&gt;</pre>
                                    </div>
                                
                                    <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>track.love</h1>
    <div class="wsdescription">
        Love a track for a user profile.
    </div>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">track</span> (Required) : A track name (utf8 encoded)<br />
                <span class="param">artist</span> (Required) : An artist name (utf8 encoded)<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                  <span class="param">api_sig</span> (Required) : A Last.fm method signature. See <a href="/api/authentication">authentication</a> for more information.<br />
                     <span class="param">sk</span> (Required) : A session key generated by authenticating a user via the authentication protocol.
                              <h2>Auth</h2>
                                     
                           This service requires authentication. Please see our <a href="/api/authentication">authentication</a> how-to.<br/>
                                        This is a <b>write</b> service and must be accessed with an HTTP POST request. All parameters should be sent in the POST body, including the 'method' parameter. See <a href="/api/rest">rest requests</a> for more information.
            l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;lfm status=&quot;ok&quot;&gt;
&lt;/lfm&gt;</pre>
                                    </div>
                                
                                    <h2>Errors</h2>
            <ul>
                                    <li><span class="param">8</span> : Operation Failed - Server Error. Please try again later.</li>
                                                <li><span class="param">6</span> : Invalid track name supplied</li>
                                                <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>track.removeTag</h1>
    <div class="wsdescription">
        Remove a user's tag from a track.
    </div>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">artist</span> (Required) : The artist name<br />
                <span class="param">track</span> (Required) : The track name<br />
                <span class="param">tag</span> (Required) : A single user tag to remove from this track.<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                  <span class="param">api_sig</span> (Required) : A Last.fm method signature. See <a href="/api/authentication">authentication</a> for more information.<br />
                     <span class="param">sk</span> (Required) : A session key generated by authenticating a user via the authentication protocol.
                              <h2>Auth</h2>
                                     
                           This service requires authentication. Please see our <a href="/api/authentication">authentication</a> how-to.<br/>
                                        This is a <b>write</b> service and must be accessed with an HTTP POST request. All parameters should be sent in the POST body, including the 'method' parameter. See <a href="/api/rest">rest requests</a> for more information.
            l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;lfm status=&quot;ok&quot;&gt;
&lt;/lfm&gt;</pre>
                                    </div>
                                
                                    <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>track.scrobble</h1>
    <div class="wsdescription">
        Used to add a track-play to a user's profile. Scrobble a track, or a
batch of tracks. Tracks are passed to the service using array notation for
each of the below params, up to a maximum of 50 scrobbles per batch
[0<=i<=49]. If you are only sending a single scrobble the array
notation may be ommited. Note: Extra care should be taken while calculating
the signature when using array notation as the parameter names MUST be
sorted according to the ASCII table (i.e., artist[10] comes before
artist[1]). It is important to not use the corrections returned by the now
playing service as input for the scrobble request, unless they have been
explicitly approved by the user. Parameter names are case sensitive.
    </div>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">artist[i]</span> (Required) : The artist name.<br />
                <span class="param">track[i]</span> (Required) : The track name.<br />
                <span class="param">timestamp[i]</span> (Required) : The time the track started playing, in UNIX timestamp format (integer number of seconds since 00:00:00, January 1st 1970 UTC). This must be in the UTC time zone.<br />
                <span class="param">album[i]</span> (Optional) : The album name.<br />
                <span class="param">context[i]</span> (Optional) : Sub-client version (not public, only enabled for certain API keys)<br />
                <span class="param">streamId[i]</span> (Optional) : The stream id for this track received from the radio.getPlaylist service, if scrobbling Last.fm radio<br />
                <span class="param">chosenByUser[i]</span> (Optional) : Set to 1 if the user chose this song, or 0 if the song was chosen by someone else (such as a radio station or recommendation service). Assumes 1 if not specified<br />
                <span class="param">trackNumber[i]</span> (Optional) : The track number of the track on the album.<br />
                <span class="param">mbid[i]</span> (Optional) : The MusicBrainz Track ID.<br />
                <span class="param">albumArtist[i]</span> (Optional) : The album artist - if this differs from the track artist.<br />
                <span class="param">duration[i]</span> (Optional) : The length of the track in seconds.<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                  <span class="param">api_sig</span> (Required) : A Last.fm method signature. See <a href="/api/authentication">authentication</a> for more information.<br />
                     <span class="param">sk</span> (Required) : A session key generated by authenticating a user via the authentication protocol.
                              <h2>Auth</h2>
                                     
                           This service requires authentication. Please see our <a href="/api/authentication">authentication</a> how-to.<br/>
                                        This is a <b>write</b> service and must be accessed with an HTTP POST request. All parameters should be sent in the POST body, including the 'method' parameter. See <a href="/api/rest">rest requests</a> for more information.
            l
            <h2>Sample Response</h2>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            <div id="sample">
                    <pre>Example for a single scrobble sent:
&lt;?xml version='1.0' encoding='utf-8'?&gt;
&lt;lfm status=&quot;ok&quot;&gt;
  &lt;scrobbles <span class="tagDescription" title="Number of accepted scrobbles">accepted</span>=&quot;1&quot; <span class="tagDescription" title="Number of ignored scrobbles (see ignoredMessage for details)">ignored</span>=&quot;0&quot;&gt;
    &lt;scrobble&gt;
      &lt;track <span class="tagDescription" title="'1', if this track, artist or album name was automatically corrected, '0' otherwise">corrected</span>=&quot;0&quot;&gt;Test Track&lt;/track&gt;
      &lt;artist <span class="tagDescription" title="'1', if this track, artist or album name was automatically corrected, '0' otherwise">corrected</span>=&quot;0&quot;&gt;Test Artist&lt;/artist&gt;
      &lt;album <span class="tagDescription" title="'1', if this track, artist or album name was automatically corrected, '0' otherwise">corrected</span>=&quot;0&quot;&gt;&lt;/album&gt;
      &lt;albumArtist <span class="tagDescription" title="'1', if this track, artist or album name was automatically corrected, '0' otherwise">corrected</span>=&quot;0&quot;&gt;&lt;/albumArtist&gt;
      &lt;timestamp&gt;1287140447&lt;/timestamp&gt;
      &lt;ignoredMessage <span class="tagDescription" title="Ignored message codes:
- 1: Artist was ignored
- 2: Track was ignored
- 3: Timestamp was too old
- 4: Timestamp was too new
- 5: Daily scrobble limit exceeded">code</span>=&quot;0&quot;&gt;&lt;/ignoredMessage&gt;
    &lt;/scrobble&gt;
  &lt;/scrobbles&gt;
&lt;/lfm&gt;

Example for 2 scrobbles sent:
&lt;?xml version='1.0' encoding='utf-8'?&gt;
&lt;lfm status=&quot;ok&quot;&gt;
  &lt;scrobbles <span class="tagDescription" title="Number of accepted scrobbles">accepted</span>=&quot;2&quot; <span class="tagDescription" title="Number of ignored scrobbles (see ignoredMessage for details)">ignored</span>=&quot;0&quot;&gt;
    &lt;scrobble&gt;
      &lt;track <span class="tagDescription" title="'1', if this track, artist or album name was automatically corrected, '0' otherwise">corrected</span>=&quot;0&quot;&gt;Test Track 0&lt;/track&gt;
      &lt;artist <span class="tagDescription" title="'1', if this track, artist or album name was automatically corrected, '0' otherwise">corrected</span>=&quot;0&quot;&gt;Test Artist 0&lt;/artist&gt;
      &lt;album <span class="tagDescription" title="'1', if this track, artist or album name was automatically corrected, '0' otherwise">corrected</span>=&quot;0&quot;&gt;&lt;/album&gt;
      &lt;albumArtist <span class="tagDescription" title="'1', if this track, artist or album name was automatically corrected, '0' otherwise">corrected</span>=&quot;0&quot;&gt;&lt;/albumArtist&gt;
      &lt;timestamp&gt;1287141093&lt;/timestamp&gt;
      &lt;ignoredMessage <span class="tagDescription" title="Ignored message codes:
- 1: Artist was ignored
- 2: Track was ignored
- 3: Timestamp was too old
- 4: Timestamp was too new
- 5: Daily scrobble limit exceeded">code</span>=&quot;0&quot;&gt;&lt;/ignoredMessage&gt;
    &lt;/scrobble&gt;
    &lt;scrobble&gt;
      &lt;track <span class="tagDescription" title="'1', if this track, artist or album name was automatically corrected, '0' otherwise">corrected</span>=&quot;0&quot;&gt;Test Track 1&lt;/track&gt;
      &lt;artist <span class="tagDescription" title="'1', if this track, artist or album name was automatically corrected, '0' otherwise">corrected</span>=&quot;0&quot;&gt;Test Artist 1&lt;/artist&gt;
      &lt;album <span class="tagDescription" title="'1', if this track, artist or album name was automatically corrected, '0' otherwise">corrected</span>=&quot;0&quot;&gt;&lt;/album&gt;
      &lt;albumArtist <span class="tagDescription" title="'1', if this track, artist or album name was automatically corrected, '0' otherwise">corrected</span>=&quot;0&quot;&gt;&lt;/albumArtist&gt;
      &lt;timestamp&gt;1287141093&lt;/timestamp&gt;
      &lt;ignoredMessage <span class="tagDescription" title="Ignored message codes:
- 1: Artist was ignored
- 2: Track was ignored
- 3: Timestamp was too old
- 4: Timestamp was too new
- 5: Daily scrobble limit exceeded">code</span>=&quot;0&quot;&gt;&lt;/ignoredMessage&gt;
    &lt;/scrobble&gt;
  &lt;/scrobbles&gt;
&lt;/lfm&gt;</pre>
                                        Hover over the underlined tags and attributes to get detailed information.
                                    </div>
                                
                                    <h2>Errors</h2>
            <ul>
                                    <li><span class="param">16</span> : The service is temporarily unavailable, please try again.</li>
                                                <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>track.search</h1>
    <div class="wsdescription">
        Search for a track by track name. Returns track matches sorted by
relevance.
    </div>
        <p class="sampleurl">
    e.g. <a href="http://ws.audioscrobbler.com/2.0/?method=track.search&track=Believe&api_key=b25b959554ed76058ac220b7b2e0a026">http://ws.audioscrobbler.com/2.0/?method=track.search&track=Believe&api_key=b25b959554ed76058ac...</a> 
    </p>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">limit</span> (Optional) : The number of results to fetch per page. Defaults to 30.<br />
                <span class="param">page</span> (Optional) : The page number to fetch.  Defaults to first page.<br />
                <span class="param">track</span> (Required) : The track name<br />
                <span class="param">artist</span> (Optional) : Narrow your search by specifying an artist.<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                     <h2>Auth</h2>
                                     
                           This service does <b>not</b> require authentication.
                        l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;results for=&quot;Believe&quot; xmlns:opensearch=&quot;http://a9.com/-/spec/opensearch/1.1/&quot;&gt;
  &lt;opensearch:Query role=&quot;request&quot; searchTerms=&quot;Believe&quot; startPage=&quot;1&quot;/&gt;
  &lt;opensearch:totalResults&gt;25329&lt;/opensearch:totalResults&gt;
  &lt;opensearch:startIndex&gt;0&lt;/opensearch:startIndex&gt;
  &lt;opensearch:itemsPerPage&gt;20&lt;/opensearch:itemsPerPage&gt;
  &lt;trackmatches&gt;
    &lt;track&gt;
      &lt;name&gt;Believe&lt;/name&gt;
      &lt;artist&gt;Disturbed&lt;/artist&gt;
      &lt;url&gt;http://www.last.fm/music/Disturbed/_/Believe&lt;/url&gt;
      &lt;streamable fulltrack=&quot;0&quot;&gt;1&lt;/streamable&gt;
      &lt;listeners&gt;66068&lt;/listeners&gt;
      &lt;image size=&quot;small&quot;&gt;...&lt;/image&gt;
    &lt;/track&gt;
    ...
  &lt;/trackmatches&gt;
&lt;/results&gt;</pre>
                                    </div>
                                
                                    <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>track.share</h1>
    <div class="wsdescription">
        Share a track twith one or more Last.fm users or other friends.
    </div>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">artist</span> (Required) : An artist name.<br />
                <span class="param">track</span> (Required) : A track name.<br />
                <span class="param">public</span> (Optional): Optionally show in the sharing users activity feed. Defaults to 0 (false).<br />
                <span class="param">message</span> (Optional): An optional message to send with the recommendation. If not supplied a default message will be used.<br />
                <span class="param">recipient</span> (Required): Email Address | Last.fm Username - A comma delimited list of email addresses or Last.fm usernames. Maximum is 10.<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                  <span class="param">api_sig</span> (Required) : A Last.fm method signature. See <a href="/api/authentication">authentication</a> for more information.<br />
                     <span class="param">sk</span> (Required) : A session key generated by authenticating a user via the authentication protocol.
                              <h2>Auth</h2>
                                     
                           This service requires authentication. Please see our <a href="/api/authentication">authentication</a> how-to.<br/>
                                        This is a <b>write</b> service and must be accessed with an HTTP POST request. All parameters should be sent in the POST body, including the 'method' parameter. See <a href="/api/rest">rest requests</a> for more information.
            l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;lfm status=&quot;ok&quot;&gt;
&lt;/lfm&gt;</pre>
                                    </div>
                                
                                    <h2>Errors</h2>
            <ul>
                                    <li><span class="param">6</span> : Invalid artist name supplied</li>
                                                <li><span class="param">8</span> : Operation Failed - Server Error. Please try again later.</li>
                                                <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>track.unban</h1>
    <div class="wsdescription">
        UnBan a track for a user profile.
    </div>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">track</span> (Required) : A track name (utf8 encoded)<br />
                <span class="param">artist</span> (Required) : An artist name (utf8 encoded)<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                  <span class="param">api_sig</span> (Required) : A Last.fm method signature. See <a href="/api/authentication">authentication</a> for more information.<br />
                     <span class="param">sk</span> (Required) : A session key generated by authenticating a user via the authentication protocol.
                              <h2>Auth</h2>
                                     
                           This service requires authentication. Please see our <a href="/api/authentication">authentication</a> how-to.<br/>
                                        This is a <b>write</b> service and must be accessed with an HTTP POST request. All parameters should be sent in the POST body, including the 'method' parameter. See <a href="/api/rest">rest requests</a> for more information.
            l
            <h2>Sample Response</h2>
                                
                                    <h2>Errors</h2>
            <ul>
                                    <li><span class="param">8</span> : Operation Failed - Server Error. Please try again later.</li>
                                                <li><span class="param">6</span> : Invalid track name supplied</li>
                                                <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>track.unlove</h1>
    <div class="wsdescription">
        UnLove a track for a user profile.
    </div>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">track</span> (Required) : A track name (utf8 encoded)<br />
                <span class="param">artist</span> (Required) : An artist name (utf8 encoded)<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                  <span class="param">api_sig</span> (Required) : A Last.fm method signature. See <a href="/api/authentication">authentication</a> for more information.<br />
                     <span class="param">sk</span> (Required) : A session key generated by authenticating a user via the authentication protocol.
                              <h2>Auth</h2>
                                     
                           This service requires authentication. Please see our <a href="/api/authentication">authentication</a> how-to.<br/>
                                        This is a <b>write</b> service and must be accessed with an HTTP POST request. All parameters should be sent in the POST body, including the 'method' parameter. See <a href="/api/rest">rest requests</a> for more information.
            l
            <h2>Sample Response</h2>
                                
                                    <h2>Errors</h2>
            <ul>
                                    <li><span class="param">8</span> : Operation Failed - Server Error. Please try again later.</li>
                                                <li><span class="param">6</span> : Invalid track name supplied</li>
                                                <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>track.updateNowPlaying</h1>
    <div class="wsdescription">
        Used to notify Last.fm that a user has started listening to a track.
Parameter names are case sensitive.
    </div>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">artist</span> (Required) : The artist name.<br />
                <span class="param">track</span> (Required) : The track name.<br />
                <span class="param">album</span> (Optional) : The album name.<br />
                <span class="param">trackNumber</span> (Optional) : The track number of the track on the album.<br />
                <span class="param">context</span> (Optional) : Sub-client version (not public, only enabled for certain API keys)<br />
                <span class="param">mbid</span> (Optional) : The MusicBrainz Track ID.<br />
                <span class="param">duration</span> (Optional) : The length of the track in seconds.<br />
                <span class="param">albumArtist</span> (Optional) : The album artist - if this differs from the track artist.<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                  <span class="param">api_sig</span> (Required) : A Last.fm method signature. See <a href="/api/authentication">authentication</a> for more information.<br />
                     <span class="param">sk</span> (Required) : A session key generated by authenticating a user via the authentication protocol.
                              <h2>Auth</h2>
                                     
                           This service requires authentication. Please see our <a href="/api/authentication">authentication</a> how-to.<br/>
                                        This is a <b>write</b> service and must be accessed with an HTTP POST request. All parameters should be sent in the POST body, including the 'method' parameter. See <a href="/api/rest">rest requests</a> for more information.
            l
            <h2>Sample Response</h2>
                                                                                                                                                                                                                                                                                                                                                                            <div id="sample">
                    <pre>&lt;?xml version='1.0' encoding='utf-8'?&gt;
&lt;lfm status=&quot;ok&quot;&gt;
  &lt;nowplaying&gt;
    &lt;track <span class="tagDescription" title="'1', if this track, artist or album name was automatically corrected, '0' otherwise">corrected</span>=&quot;0&quot;&gt;Test Track&lt;/track&gt;
    &lt;artist <span class="tagDescription" title="'1', if this track, artist or album name was automatically corrected, '0' otherwise">corrected</span>=&quot;0&quot;&gt;Test Artist&lt;/artist&gt;
    &lt;album <span class="tagDescription" title="'1', if this track, artist or album name was automatically corrected, '0' otherwise">corrected</span>=&quot;0&quot;&gt;&lt;/album&gt;
    &lt;albumArtist <span class="tagDescription" title="'1', if this track, artist or album name was automatically corrected, '0' otherwise">corrected</span>=&quot;0&quot;&gt;&lt;/albumArtist&gt;
    &lt;ignoredMessage <span class="tagDescription" title="Ignored message codes:
- 1: Artist was ignored
- 2: Track was ignored
- 3: Timestamp was too old
- 4: Timestamp was too new
- 5: Daily scrobble limit exceeded">code</span>=&quot;0&quot;&gt;&lt;/ignoredMessage&gt;
  &lt;/nowplaying&gt;
&lt;/lfm&gt;</pre>
                                        Hover over the underlined tags and attributes to get detailed information.
                                    </div>
                                
                                    <h2>Errors</h2>
            <ul>
                                    <li><span class="param">16</span> : The service is temporarily unavailable, please try again.</li>
                                                <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>user.getArtistTracks</h1>
    <div class="wsdescription">
        Get a list of tracks by a given artist scrobbled by this user, including
scrobble time. Can be limited to specific timeranges, defaults to all time.
    </div>
        <p class="sampleurl">
    e.g. <a href="http://ws.audioscrobbler.com/2.0/?method=user.getartisttracks&user=rj&artist=metallica&api_key=b25b959554ed76058ac220b7b2e0a026">http://ws.audioscrobbler.com/2.0/?method=user.getartisttracks&user=rj&artist=metallica&api_key=...</a> 
    </p>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">user</span> (Required) : The last.fm username to fetch the recent tracks of.<br />
                <span class="param">artist</span> (Required) : The artist name you are interested in<br />
                <span class="param">startTimestamp</span> (Optional) : An unix timestamp to start at.<br />
                <span class="param">page</span> (Optional) : The page number to fetch.  Defaults to first page.<br />
                <span class="param">endTimestamp</span> (Optional) : An unix timestamp to end at.<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                     <h2>Auth</h2>
                                     
                           This service does <b>not</b> require authentication.
                        l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;?xml version=&quot;1.0&quot; encoding=&quot;utf-8&quot;?&gt;
    &lt;lfm status=&quot;ok&quot;&gt;
        &lt;artisttracks user=&quot;RJ&quot; artist=&quot;Metallica&quot; page=&quot;1&quot; perPage=&quot;50&quot; totalPages=&quot;6&quot; items=&quot;278&quot;&gt;
            &lt;track&gt; 
                &lt;artist mbid=&quot;65f4f0c5-ef9e-490c-aee3-909e7ae6b2ab&quot;&gt;Metallica&lt;/artist&gt;
                &lt;name&gt;Better Than You&lt;/name&gt;
                &lt;streamable&gt;0&lt;/streamable&gt;
                &lt;mbid&gt;&lt;/mbid&gt;
                &lt;album mbid=&quot;b05cf8e3-67ad-4d40-9dc1-3a697e3a1bf8&quot;&gt;Reload&lt;/album&gt;
                &lt;url&gt;http://www.last.fm/music/Metallica/_/Better+Than+You&lt;/url&gt;
                &lt;image size=&quot;small&quot;&gt;http://userserve-ak.last.fm/serve/34s/8600317.jpg&lt;/image&gt;
                &lt;image size=&quot;medium&quot;&gt;http://userserve-ak.last.fm/serve/64s/8600317.jpg&lt;/image&gt;
                &lt;image size=&quot;large&quot;&gt;http://userserve-ak.last.fm/serve/126/8600317.jpg&lt;/image&gt;
                &lt;image size=&quot;extralarge&quot;&gt;http://userserve-ak.last.fm/serve/300x300/8600317.jpg&lt;/image&gt;
                &lt;date uts=&quot;1262887346&quot;&gt;7 Jan 2010, 18:02&lt;/date&gt;
        &lt;/track&gt;
        ...
&lt;/artisttracks&gt;
&lt;/lfm&gt;</pre>
                                    </div>
                                
                                    <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>user.getBannedTracks</h1>
    <div class="wsdescription">
        Returns the tracks banned by the user
    </div>
        <p class="sampleurl">
    e.g. <a href="http://ws.audioscrobbler.com/2.0/?method=user.getbannedtracks&user=rj&api_key=b25b959554ed76058ac220b7b2e0a026">http://ws.audioscrobbler.com/2.0/?method=user.getbannedtracks&user=rj&api_key=b25b959554ed76058...</a> 
    </p>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">user</span> (Required) : The user name<br />
                <span class="param">limit</span> (Optional) : The number of results to fetch per page. Defaults to 50.<br />
                <span class="param">page</span> (Optional) : The page number to fetch.  Defaults to first page.<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                     <h2>Auth</h2>
                                     
                           This service does <b>not</b> require authentication.
                        l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;bannedtracks user=&quot;RJ&quot; total=&quot;228&quot; page=&quot;1&quot; perPage=&quot;50&quot; totalPages=&quot;5&quot;&gt;
  &lt;track&gt;
    &lt;name&gt;Smut&lt;/name&gt;
    &lt;mbid/&gt;
    &lt;url&gt;www.last.fm/music/Tom+Lehrer/_/Smut&lt;/url&gt;
    &lt;date uts=&quot;1286548995&quot;&gt;8 Oct 2010, 14:43&lt;/date&gt;
    &lt;artist&gt;
      &lt;name&gt;Tom Lehrer&lt;/name&gt;
      &lt;mbid&gt;359363a8-1dc7-40c9-9337-f5aa507000b6&lt;/mbid&gt;
      &lt;url&gt;http://www.last.fm/music/Tom+Lehrer&lt;/url&gt;
    &lt;/artist&gt;
    &lt;image size=&quot;small&quot;&gt;http://userserve-ak.last.fm/serve/34s/12619575.jpg&lt;/image&gt;
    &lt;image size=&quot;medium&quot;&gt;http://userserve-ak.last.fm/serve/64s/12619575.jpg&lt;/image&gt;
    &lt;image size=&quot;large&quot;&gt;http://userserve-ak.last.fm/serve/126/12619575.jpg&lt;/image&gt;
    &lt;image size=&quot;extralarge&quot;&gt;http://userserve-ak.last.fm/serve/300x300/12619575.jpg&lt;/image&gt;
    &lt;streamable fulltrack=&quot;0&quot;&gt;1&lt;/streamable&gt;
  &lt;/track&gt;
  ...
&lt;/bannedtracks&gt;</pre>
                                    </div>
                                
                    <h2>Other Formats</h2>
                            Also available as a feed in <b>rss</b> format                <p>
                                    e.g. <a href="http://ws.audioscrobbler.com/2.0/user/rj/bannedtracks.rss">http://ws.audioscrobbler.com/2.0/user/rj/bannedtracks.rss</a><br />
                                </p>
                                                <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>user.getEvents</h1>
    <div class="wsdescription">
        Get a list of upcoming events that this user is attending. Easily
integratable into calendars, using the ical standard (see 'more
formats' section below).
    </div>
        <p class="sampleurl">
    e.g. <a href="http://ws.audioscrobbler.com/2.0/?method=user.getevents&user=mokele&api_key=b25b959554ed76058ac220b7b2e0a026">http://ws.audioscrobbler.com/2.0/?method=user.getevents&user=mokele&api_key=b25b959554ed76058ac...</a> 
    </p>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">user</span> (Required) : The user to fetch the events for.<br />
                <span class="param">page</span> (Optional) : The page number to fetch.  Defaults to first page.<br />
                <span class="param">festivalsonly[0|1]</span> (Optional) : Whether only festivals should be returned, or all events.<br />
                <span class="param">limit</span> (Optional) : The number of results to fetch per page. Defaults to 50.<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                     <h2>Auth</h2>
                                     
                           This service does <b>not</b> require authentication.
                        l
            <h2>Sample Response</h2>
                                                                                                                                                                                                                                            <div id="sample">
                    <pre>&lt;events user=&quot;mokele&quot; xmlns:geo=&quot;http://www.w3.org/2003/01/geo/wgs84_pos#&quot; total=&quot;23&quot;&gt;
&lt;event <span class="tagDescription" title="A value of '0' indicates that the user went to the event, a value of '1' indicates this user was interested in going">status</span>=&quot;0&quot;&gt;
  &lt;id&gt;544957&lt;/id&gt;
  &lt;title&gt;Cult of Luna&lt;/title&gt;
  &lt;artists&gt;
    &lt;artist&gt;Cult of Luna&lt;/artist&gt;
    &lt;artist&gt;The Ocean&lt;/artist&gt;
    &lt;artist&gt;Devil Sold His Soul&lt;/artist&gt;
    &lt;headliner&gt;Cult of Luna&lt;/headliner&gt;
  &lt;/artists&gt;
  &lt;venue&gt;
    &lt;name&gt;Scala&lt;/name&gt;
    &lt;location&gt;
      &lt;city&gt;London&lt;/city&gt;
      &lt;country&gt;United Kingdom&lt;/country&gt;
      &lt;street&gt;275 Pentonville Road, Kings Cross&lt;/street&gt;
      &lt;postalcode&gt;N1 9NL&lt;/postalcode&gt;
      &lt;geo:point&gt;
         &lt;geo:lat&gt;51.530767071208&lt;/geo:lat&gt;
         &lt;geo:long&gt;-0.120263446498872&lt;/geo:long&gt;
      &lt;/geo:point&gt;
      &lt;timezone&gt;GMT&lt;/timezone&gt;
    &lt;/location&gt;
    &lt;url&gt;http://www.last.fm/venue/8777871&lt;/url&gt;
  &lt;/venue&gt;
  &lt;startDate&gt;Tue, 01 Jul 2008&lt;/startDate&gt;
  &lt;description&gt;&lt;/description&gt;
  &lt;image size=&quot;small&quot;&gt;...&lt;/image&gt;
  &lt;image size=&quot;medium&quot;&gt;...&lt;/image&gt;
  &lt;image size=&quot;large&quot;&gt;...&lt;/image&gt;
  &lt;attendance&gt;42&lt;/attendance&gt;
  &lt;reviews&gt;0&lt;/reviews&gt;
  &lt;tag&gt;lastfm:event=544957&lt;/tag&gt;
  &lt;url&gt;http://www.last.fm/event/544957&lt;/url&gt;
  &lt;website&gt;http://...&lt;/website&gt;
  &lt;tickets&gt;
    &lt;ticket supplier=&quot;...&quot;&gt;http://...&lt;/ticket&gt;
    ...
  &lt;/tickets&gt;
&lt;/event&gt;
...
&lt;/events&gt;</pre>
                                        Hover over the underlined tags and attributes to get detailed information.
                                    </div>
                                
                    <h2>Other Formats</h2>
                            Also available as a feed in <b>rss,ical</b> formats                <p>
                                    e.g. <a href="http://ws.audioscrobbler.com/2.0/user/rj/events.rss">http://ws.audioscrobbler.com/2.0/user/rj/events.rss</a><br />
                                    e.g. <a href="http://ws.audioscrobbler.com/2.0/user/rj/events.ical">http://ws.audioscrobbler.com/2.0/user/rj/events.ical</a><br />
                                </p>
                                                <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>user.getFriends</h1>
    <div class="wsdescription">
        Get a list of the user's friends on Last.fm.
    </div>
        <p class="sampleurl">
    e.g. <a href="http://ws.audioscrobbler.com/2.0/?method=user.getfriends&user=rj&api_key=b25b959554ed76058ac220b7b2e0a026">http://ws.audioscrobbler.com/2.0/?method=user.getfriends&user=rj&api_key=b25b959554ed76058ac220...</a> 
    </p>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">user</span> (Required) : The last.fm username to fetch the friends of.<br />
                <span class="param">recenttracks</span> (Optional) : Whether or not to include information about friends' recent listening in the response.<br />
                <span class="param">limit</span> (Optional) : The number of results to fetch per page. Defaults to 50.<br />
                <span class="param">page</span> (Optional) : The page number to fetch.  Defaults to first page.<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                     <h2>Auth</h2>
                                     
                           This service does <b>not</b> require authentication.
                        l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;lfm status=&quot;ok&quot; total=&quot;109&quot; page=&quot;1&quot; perPage=&quot;50&quot; totalPages=&quot;3&quot;&gt;
    &lt;friends user=&quot;joanofarctan&quot;&gt;
        &lt;user&gt;
            &lt;name&gt;eartle&lt;/name&gt;
            &lt;realname&gt;Michael Coffey&lt;/realname&gt;
            &lt;image size=&quot;small&quot;&gt;http://userserve-ak.last.fm/serve/34/45718509.jpg&lt;/image&gt;
            &lt;image size=&quot;medium&quot;&gt;http://userserve-ak.last.fm/serve/64/45718509.jpg&lt;/image&gt;
            &lt;image size=&quot;large&quot;&gt;http://userserve-ak.last.fm/serve/126/45718509.jpg&lt;/image&gt;
            &lt;image size=&quot;extralarge&quot;&gt;http://userserve-ak.last.fm/serve/252/45718509.jpg&lt;/image&gt;
            &lt;url&gt;http://www.last.fm/user/eartle&lt;/url&gt;
            &lt;id&gt;7737850&lt;/id&gt;
            &lt;country&gt;UK&lt;/country&gt;
            &lt;age&gt;29&lt;/age&gt;
            &lt;gender&gt;m&lt;/gender&gt;
            &lt;subscriber&gt;1&lt;/subscriber&gt;
            &lt;playcount&gt;45366&lt;/playcount&gt;
            &lt;playlists&gt;4&lt;/playlists&gt;
            &lt;bootstrap&gt;0&lt;/bootstrap&gt;
            &lt;registered unixtime=&quot;1189696970&quot;&gt;2007-09-13 15:22&lt;/registered&gt;
            &lt;type&gt;subscriber&lt;/type&gt;
        &lt;/user&gt;
        ...
    &lt;/friends&gt;
&lt;/lfm&gt;</pre>
                                    </div>
                                
                                    <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>user.getInfo</h1>
    <div class="wsdescription">
        Get information about a user profile.
    </div>
        <p class="sampleurl">
    e.g. <a href="http://ws.audioscrobbler.com/2.0/?method=user.getinfo&user=rj&api_key=b25b959554ed76058ac220b7b2e0a026">http://ws.audioscrobbler.com/2.0/?method=user.getinfo&user=rj&api_key=b25b959554ed76058ac220b7b...</a> 
    </p>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">user</span> (Optional) : The user to fetch info for.  Defaults to the authenticated user.<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                     <h2>Auth</h2>
                                     
                           This service does <b>not</b> require authentication.
                        l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;user&gt;
    &lt;id&gt;1000002&lt;/id&gt;
    &lt;name&gt;RJ&lt;/name&gt;
    &lt;realname&gt;Richard Jones &lt;/realname&gt;
    &lt;url&gt;http://www.last.fm/user/RJ&lt;/url&gt;
    &lt;image&gt;http://userserve-ak.last.fm/serve/126/8270359.jpg&lt;/image&gt;
    &lt;country&gt;UK&lt;/country&gt;
    &lt;age&gt;27&lt;/age&gt;
    &lt;gender&gt;m&lt;/gender&gt;
    &lt;subscriber&gt;1&lt;/subscriber&gt;
    &lt;playcount&gt;54189&lt;/playcount&gt;
    &lt;playlists&gt;4&lt;/playlists&gt;
    &lt;bootstrap&gt;0&lt;/bootstrap&gt;
    &lt;registered unixtime=&quot;1037793040&quot;&gt;2002-11-20 11:50&lt;/registered&gt;
&lt;/user&gt;</pre>
                                    </div>
                                
                                    <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>user.getLovedTracks</h1>
    <div class="wsdescription">
        Get the last 50 tracks loved by a user.
    </div>
        <p class="sampleurl">
    e.g. <a href="http://ws.audioscrobbler.com/2.0/?method=user.getlovedtracks&user=rj&api_key=b25b959554ed76058ac220b7b2e0a026">http://ws.audioscrobbler.com/2.0/?method=user.getlovedtracks&user=rj&api_key=b25b959554ed76058a...</a> 
    </p>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">user</span> (Required) : The user name to fetch the loved tracks for.<br />
                <span class="param">limit</span> (Optional) : The number of results to fetch per page. Defaults to 50.<br />
                <span class="param">page</span> (Optional) : The page number to fetch.  Defaults to first page.<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                     <h2>Auth</h2>
                                     
                           This service does <b>not</b> require authentication.
                        l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;lovedtracks user=&quot;RJ&quot;&gt;
  &lt;track&gt;
    &lt;name&gt;The Glass Prison&lt;/name&gt;
    &lt;mbid/&gt;
    &lt;url&gt;www.last.fm/music/Dream+Theater/_/The+Glass+Prison&lt;/url&gt;
    &lt;date uts=&quot;1216371514&quot;&gt;18 Jul 2008, 08:58&lt;/date&gt;
    &lt;artist&gt;
      &lt;name&gt;Dream Theater&lt;/name&gt;
      &lt;mbid&gt;28503ab7-8bf2-4666-a7bd-2644bfc7cb1d&lt;/mbid&gt;
      &lt;url&gt;http://www.last.fm/music/Dream+Theater&lt;/url&gt;
    &lt;/artist&gt;
    &lt;image size=&quot;small&quot;&gt;...&lt;/image&gt;
    &lt;image size=&quot;medium&quot;&gt;...&lt;/image&gt;
    &lt;image size=&quot;large&quot;&gt;...&lt;/image&gt;
  &lt;/track&gt;
  ...
&lt;/lovedtracks&gt;</pre>
                                    </div>
                                
                    <h2>Other Formats</h2>
                            Also available as a feed in <b>rss</b> format                <p>
                                    e.g. <a href="http://ws.audioscrobbler.com/2.0/user/rj/lovedtracks.rss">http://ws.audioscrobbler.com/2.0/user/rj/lovedtracks.rss</a><br />
                                </p>
                                                <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>user.getNeighbours</h1>
    <div class="wsdescription">
        Get a list of a user's neighbours on Last.fm.
    </div>
        <p class="sampleurl">
    e.g. <a href="http://ws.audioscrobbler.com/2.0/?method=user.getneighbours&user=rj&api_key=b25b959554ed76058ac220b7b2e0a026">http://ws.audioscrobbler.com/2.0/?method=user.getneighbours&user=rj&api_key=b25b959554ed76058ac...</a> 
    </p>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">user</span> (Required) : The last.fm username to fetch the neighbours of.<br />
                <span class="param">limit</span> (Optional) : The number of results to fetch per page. Defaults to 50.<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                     <h2>Auth</h2>
                                     
                           This service does <b>not</b> require authentication.
                        l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;lfm status=&quot;ok&quot;&gt;
	&lt;neighbours for=&quot;joanofarctan&quot;&gt;
		&lt;user&gt;
			&lt;name&gt;polaroide&lt;/name&gt;
			&lt;url&gt;http://www.last.fm/user/polaroide/&lt;/url&gt;
			&lt;image&gt;http://userserve-ak.last.fm/serve//1451306.gif&lt;/image&gt;
			&lt;match&gt;100&lt;/match&gt;
		&lt;/user&gt;
		...
	&lt;/neighbours&gt;	
&lt;/lfm&gt;</pre>
                                    </div>
                                
                                    <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>user.getNewReleases</h1>
    <div class="wsdescription">
        Gets a list of forthcoming releases based on a user's musical taste.
    </div>
        <p class="sampleurl">
    e.g. <a href="http://ws.audioscrobbler.com/2.0/?method=user.getnewreleases&user=rj&api_key=b25b959554ed76058ac220b7b2e0a026">http://ws.audioscrobbler.com/2.0/?method=user.getnewreleases&user=rj&api_key=b25b959554ed76058a...</a> 
    </p>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">user</span> (Required) : The Last.fm username.<br />
                <span class="param">userecs</span> (Optional) : 0 or 1. If 1, the feed contains new releases based on Last.fm's artist recommendations for this user. Otherwise, it is based on their library (the default).<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                     <h2>Auth</h2>
                                     
                           This service does <b>not</b> require authentication.
                        l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;albums user=&quot;RJ&quot;&gt;
  &lt;album releasedate=&quot;Mon, 15 Nov 2010 00:00:00 +0000&quot;&gt;
    &lt;name&gt;Darkness On The Edge Of Town (2010 Remastered Version)&lt;/name&gt;
    &lt;mbid/&gt;
    &lt;url&gt;http://www.last.fm/music/Bruce+Springsteen/Darkness+On+The+Edge+Of+Town+%282010+Remastered+Version%29&lt;/url&gt;−
    &lt;artist&gt;
      &lt;name&gt;Bruce Springsteen&lt;/name&gt;
      &lt;mbid&gt;70248960-cb53-4ea4-943a-edb18f7d336f&lt;/mbid&gt;
      &lt;url&gt;http://www.last.fm/music/Bruce+Springsteen&lt;/url&gt;
    &lt;/artist&gt;
    &lt;image size=&quot;small&quot;&gt;http://userserve-ak.last.fm/serve/34s/54475249.jpg&lt;/image&gt;
    &lt;image size=&quot;medium&quot;&gt;http://userserve-ak.last.fm/serve/64s/54475249.jpg&lt;/image&gt;
    &lt;image size=&quot;large&quot;&gt;http://userserve-ak.last.fm/serve/126/54475249.jpg&lt;/image&gt;
    &lt;image size=&quot;extralarge&quot;&gt;http://userserve-ak.last.fm/serve/300x300/54475249.jpg&lt;/image&gt;
  &lt;/album&gt;
  ...
&lt;/albums&gt;</pre>
                                    </div>
                                
                    <h2>Other Formats</h2>
                            Also available as a feed in <b>rss</b> format                <p>
                                    e.g. <a href="http://ws.audioscrobbler.com/2.0/user/rj/newreleases.rss">http://ws.audioscrobbler.com/2.0/user/rj/newreleases.rss</a><br />
                                </p>
                                                <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>user.getPastEvents</h1>
    <div class="wsdescription">
        Get a paginated list of all events a user has attended in the past.
    </div>
        <p class="sampleurl">
    e.g. <a href="http://ws.audioscrobbler.com/2.0/?method=user.getpastevents&user=joanofarctan&api_key=b25b959554ed76058ac220b7b2e0a026">http://ws.audioscrobbler.com/2.0/?method=user.getpastevents&user=joanofarctan&api_key=b25b95955...</a> 
    </p>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">user</span> (Required) : The username to fetch the events for.<br />
                <span class="param">page</span> (Optional) : The page number to scan to.<br />
                <span class="param">limit</span> (Optional) : The number of results to fetch per page. Defaults to 50.<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                     <h2>Auth</h2>
                                     
                           This service does <b>not</b> require authentication.
                        l
            <h2>Sample Response</h2>
                                                                                                                                                                                                                                            <div id="sample">
                    <pre>&lt;events user=&quot;joanofarctan&quot; page=&quot;1&quot; perPage=&quot;20&quot; totalPages=&quot;4&quot; total=&quot;77&quot;&gt;
&lt;event <span class="tagDescription" title="A value of '0' indicates that the user went to the event, a value of '1' indicates this user was interested in going">status</span>=&quot;0&quot;&gt;
  &lt;id&gt;640418&lt;/id&gt;
  &lt;title&gt;Nikka Costa&lt;/title&gt;
  &lt;artists&gt;
    &lt;artist&gt;Nikka Costa&lt;/artist&gt;
    &lt;headliner&gt;Nikka Costa&lt;/headliner&gt;
  &lt;/artists&gt;
  &lt;venue&gt;
    &lt;name&gt;Bowery Ballroom&lt;/name&gt;
    &lt;location&gt;
      &lt;city&gt;New York&lt;/city&gt;
      &lt;country&gt;United States&lt;/country&gt;
      &lt;street&gt;6 Delancey&lt;/street&gt;
      &lt;postalcode&gt;10002&lt;/postalcode&gt;
      &lt;geo:point&gt;
         &lt;geo:lat&gt;40.71417&lt;/geo:lat&gt;
         &lt;geo:long&gt;-74.00639&lt;/geo:long&gt;
      &lt;/geo:point&gt;
      &lt;timezone&gt;EST&lt;/timezone&gt;
    &lt;/location&gt;
    &lt;url&gt;http://www.last.fm/venue/8779095&lt;/url&gt;
  &lt;/venue&gt;
  &lt;startDate&gt;Mon, 30 Jun 2008&lt;/startDate&gt;
  &lt;startTime&gt;20:00&lt;/startTime&gt;
  &lt;description&gt;&lt;![CDATA[Doors 8pm&lt;br /&gt;
$20&lt;br /&gt;
18+]]&gt;&lt;/description&gt;
  &lt;image size=&quot;small&quot;&gt;...&lt;/image&gt;
  &lt;image size=&quot;medium&quot;&gt;...&lt;/image&gt;
  &lt;image size=&quot;large&quot;&gt;...&lt;/image&gt;
  &lt;attendance&gt;42&lt;/attendance&gt;
  &lt;reviews&gt;0&lt;/reviews&gt;
  &lt;tag&gt;lastfm:event=640418&lt;/tag&gt;
  &lt;url&gt;http://www.last.fm/event/640418&lt;/url&gt;
  &lt;website&gt;http://...&lt;/website&gt;
  &lt;tickets&gt;
    &lt;ticket supplier=&quot;...&quot;&gt;http://...&lt;/ticket&gt;
    ...
  &lt;/tickets&gt;
&lt;/event&gt;
...
&lt;/events&gt;</pre>
                                        Hover over the underlined tags and attributes to get detailed information.
                                    </div>
                                
                    <h2>Other Formats</h2>
                            Also available as a feed in <b>rss,ical</b> formats                <p>
                                    e.g. <a href="http://ws.audioscrobbler.com/2.0/user/rj/pastevents.rss">http://ws.audioscrobbler.com/2.0/user/rj/pastevents.rss</a><br />
                                    e.g. <a href="http://ws.audioscrobbler.com/2.0/user/rj/pastevents.ical">http://ws.audioscrobbler.com/2.0/user/rj/pastevents.ical</a><br />
                                </p>
                                                <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>user.getPersonalTags</h1>
    <div class="wsdescription">
        Get the user's personal tags
    </div>
        <p class="sampleurl">
    e.g. <a href="http://ws.audioscrobbler.com/2.0/?method=user.getpersonaltags&user=rj&tag=rock&taggingtype=artist&api_key=b25b959554ed76058ac220b7b2e0a026">http://ws.audioscrobbler.com/2.0/?method=user.getpersonaltags&user=rj&tag=rock&taggingtype=arti...</a> 
    </p>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">user</span> (Required) : The user who performed the taggings.<br />
                <span class="param">tag</span> (Required) : The tag you're interested in.<br />
                <span class="param">taggingtype[artist|album|track]</span> (Required) : The type of items which have been tagged<br />
                <span class="param">limit</span> (Optional) : The number of results to fetch per page. Defaults to 50.<br />
                <span class="param">page</span> (Optional) : The page number to fetch.  Defaults to first page.<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                     <h2>Auth</h2>
                                     
                           This service does <b>not</b> require authentication.
                        l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;taggings user=&quot;RJ&quot; tag=&quot;rock&quot; page=&quot;1&quot; perPage=&quot;50&quot; totalPages=&quot;1&quot; total=&quot;11&quot;&gt;
  &lt;artists&gt;
    &lt;artist&gt;
      &lt;name&gt;John Hammond&lt;/name&gt;
      &lt;mbid&gt;d83e599c-2d5a-44ec-b727-587e1455b1b5&lt;/mbid&gt;
      &lt;url&gt;http://www.last.fm/music/John+Hammond&lt;/url&gt;
      &lt;streamable&gt;1&lt;/streamable&gt;
      &lt;image size=&quot;small&quot;&gt;http://userserve-ak.last.fm/serve/34/255418.jpg&lt;/image&gt;
      &lt;image size=&quot;medium&quot;&gt;http://userserve-ak.last.fm/serve/64/255418.jpg&lt;/image&gt;
      &lt;image size=&quot;large&quot;&gt;http://userserve-ak.last.fm/serve/126/255418.jpg&lt;/image&gt;
      &lt;image size=&quot;extralarge&quot;&gt;http://userserve-ak.last.fm/serve/252/255418.jpg&lt;/image&gt;
      &lt;image size=&quot;mega&quot;&gt;http://userserve-ak.last.fm/serve/_/255418/John+Hammond.jpg&lt;/image&gt;
    &lt;/artist&gt;
  &lt;/artists&gt;
&lt;/taggings&gt;</pre>
                                    </div>
                                
                                    <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>user.getPlaylists</h1>
    <div class="wsdescription">
        Get a list of a user's playlists on Last.fm.
    </div>
        <p class="sampleurl">
    e.g. <a href="http://ws.audioscrobbler.com/2.0/?method=user.getplaylists&user=rj&api_key=b25b959554ed76058ac220b7b2e0a026">http://ws.audioscrobbler.com/2.0/?method=user.getplaylists&user=rj&api_key=b25b959554ed76058ac2...</a> 
    </p>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">user</span> (Required) : The last.fm username to fetch the playlists of.<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                     <h2>Auth</h2>
                                     
                           This service does <b>not</b> require authentication.
                        l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;playlists user=&quot;RJ&quot;&gt;
  &lt;playlist&gt;
    &lt;id&gt;2615079&lt;/id&gt;
    &lt;title&gt;Duck playlist&lt;/title&gt;
    &lt;description&gt;Duck and cover&lt;/description&gt;
    &lt;date&gt;2008-05-22T09:40:09&lt;/date&gt;
    &lt;size&gt;10&lt;/size&gt;
    &lt;duration&gt;2143&lt;/duration&gt;
    &lt;streamable&gt;0&lt;/streamable&gt;
    &lt;creator&gt;http://www.last.fm/user/RJ&lt;/creator&gt;
    &lt;url&gt;http://www.last.fm/user/RJ/library/playlists/1k1t3_duck_playlist&lt;/url&gt;
    &lt;image size=&quot;small&quot;&gt;http://userserve-ak.last.fm/serve/34/5985590.jpg&lt;/image&gt;
    &lt;image size=&quot;medium&quot;&gt;http://userserve-ak.last.fm/serve/64/5985590.jpg&lt;/image&gt;
    &lt;image size=&quot;large&quot;&gt;http://userserve-ak.last.fm/serve/126/5985590.jpg&lt;/image&gt;
  &lt;/playlist&gt;
  ...
&lt;/playlists&gt;</pre>
                                    </div>
                                
                                    <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>user.getRecentStations</h1>
    <div class="wsdescription">
        Get a list of the recent Stations listened to by this user.
    </div>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">user</span> (Required) : The last.fm username to fetch the recent Stations of.<br />
                <span class="param">limit</span> (Optional) : The number of results to fetch per page. Defaults to 10. Maximum is 25.<br />
                <span class="param">page</span> (Optional) : The page number to fetch.  Defaults to first page.<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                  <span class="param">api_sig</span> (Required) : A Last.fm method signature. See <a href="/api/authentication">authentication</a> for more information.<br />
                     <span class="param">sk</span> (Required) : A session key generated by authenticating a user via the authentication protocol.
                              <h2>Auth</h2>
                                     
                           This service requires authentication. Please see our <a href="/api/authentication">authentication</a> how-to.<br/>
                        l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;recentstations user=&quot;joanofarctan&quot; page=&quot;1&quot; perPage=&quot;10&quot; totalPages=&quot;1&quot; total=&quot;7&quot;&gt;
  &lt;station&gt;
    &lt;type&gt;artist/similarartists&lt;/type&gt;
    &lt;name&gt;Cher Radio&lt;/name&gt;
    &lt;url&gt;lastfm://artist/Cher/similarartists&lt;/url&gt;
    &lt;resources&gt;
      &lt;resource type=&quot;artist&quot;&gt;
        &lt;name&gt;Cher&lt;/name&gt;
        &lt;url&gt;http://www.last.fm/music/Cher&lt;/url&gt;
        &lt;image size=&quot;small&quot;&gt;http://userserve-ak.last.fm/serve/34/285717.jpg&lt;/image&gt;
        &lt;image size=&quot;medium&quot;&gt;http://userserve-ak.last.fm/serve/64/285717.jpg&lt;/image&gt;
        &lt;image size=&quot;large&quot;&gt;http://userserve-ak.last.fm/serve/126/285717.jpg&lt;/image&gt;
      &lt;/resource&gt;
    &lt;/resources&gt;
  &lt;/station&gt;
  &lt;station&gt;
    &lt;type&gt;globaltags&lt;/type&gt;
    &lt;name&gt;math rock Tag Radio&lt;/name&gt;
    &lt;url&gt;lastfm://globaltags/math%20rock&lt;/url&gt;
    &lt;resources&gt;
      &lt;resource type=&quot;tag&quot;&gt;
        &lt;name&gt;math rock&lt;/name&gt;
        &lt;url&gt;http://www.last.fm/tag/math%20rock&lt;/url&gt;
        &lt;image size=&quot;small&quot;/&gt;
        &lt;image size=&quot;medium&quot;/&gt;
        &lt;image size=&quot;large&quot;/&gt;
      &lt;/resource&gt;
    &lt;/resources&gt;
  &lt;/station&gt;
  &lt;station&gt;
	...
  &lt;/station&gt;
&lt;/recentstations&gt;</pre>
                                    </div>
                                
                                    <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>user.getRecentTracks</h1>
    <div class="wsdescription">
        Get a list of the recent tracks listened to by this user. Also includes the
currently playing track with the nowplaying="true" attribute if
the user is currently listening.
    </div>
        <p class="sampleurl">
    e.g. <a href="http://ws.audioscrobbler.com/2.0/?method=user.getrecenttracks&user=rj&api_key=b25b959554ed76058ac220b7b2e0a026">http://ws.audioscrobbler.com/2.0/?method=user.getrecenttracks&user=rj&api_key=b25b959554ed76058...</a> 
    </p>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">user</span> (Required) : The last.fm username to fetch the recent tracks of.<br />
                <span class="param">limit</span> (Optional) : The number of results to fetch per page. Defaults to 50. Maximum is 200.<br />
                <span class="param">page</span> (Optional) : The page number to fetch.  Defaults to first page.<br />
                <span class="param">to</span> (Optional) : End timestamp of a range - only display scrobbles before this time, in UNIX timestamp format (integer number of seconds since 00:00:00, January 1st 1970 UTC). This must be in the UTC time zone.<br />
                <span class="param">from</span> (Optional) : Beginning timestamp of a range - only display scrobbles after this time, in UNIX timestamp format (integer number of seconds since 00:00:00, January 1st 1970 UTC). This must be in the UTC time zone.<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                     <h2>Auth</h2>
                                     
                           This service does <b>not</b> require authentication.
                        l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;recenttracks user=&quot;RJ&quot; page=&quot;1&quot; perPage=&quot;10&quot; totalPages=&quot;3019&quot;&gt;
  &lt;track nowplaying=&quot;true&quot;&gt;
    &lt;artist mbid=&quot;2f9ecbed-27be-40e6-abca-6de49d50299e&quot;&gt;Aretha Franklin&lt;/artist&gt;
    &lt;name&gt;Sisters Are Doing It For Themselves&lt;/name&gt;
    &lt;mbid/&gt;
    &lt;album mbid=&quot;&quot;/&gt;
    &lt;url&gt;www.last.fm/music/Aretha+Franklin/_/Sisters+Are+Doing+It+For+Themselves&lt;/url&gt;
    &lt;date uts=&quot;1213031819&quot;&gt;9 Jun 2008, 17:16&lt;/date&gt;
    &lt;streamable&gt;1&lt;/streamable&gt;
  &lt;/track&gt;
  ...
&lt;/recenttracks&gt;</pre>
                                    </div>
                                
                    <h2>Other Formats</h2>
                            Also available as a feed in <b>rss,json</b> formats                <p>
                                    e.g. <a href="http://ws.audioscrobbler.com/2.0/user/rj/recenttracks.rss">http://ws.audioscrobbler.com/2.0/user/rj/recenttracks.rss</a><br />
                                    e.g. <a href="http://ws.audioscrobbler.com/2.0/user/rj/recenttracks.json">http://ws.audioscrobbler.com/2.0/user/rj/recenttracks.json</a><br />
                                </p>
                                                <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>user.getRecommendedArtists</h1>
    <div class="wsdescription">
        Get Last.fm artist recommendations for a user
    </div>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">page</span> (Optional) : The page number to fetch.  Defaults to first page.<br />
                <span class="param">limit</span> (Optional) : The number of results to fetch per page. Defaults to 50.<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                  <span class="param">api_sig</span> (Required) : A Last.fm method signature. See <a href="/api/authentication">authentication</a> for more information.<br />
                     <span class="param">sk</span> (Required) : A session key generated by authenticating a user via the authentication protocol.
                              <h2>Auth</h2>
                                     
                           This service requires authentication. Please see our <a href="/api/authentication">authentication</a> how-to.<br/>
                        l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;recommendations user=&quot;joanofarctan&quot; page=&quot;4&quot; perPage=&quot;50&quot; totalPages=&quot;6&quot; total=&quot;276&quot;&gt;
  &lt;artist&gt;
    &lt;name&gt;Quest.Room.Project&lt;/name&gt;
    &lt;mbid/&gt;
    &lt;url&gt;http://www.last.fm/music/Quest.Room.Project&lt;/url&gt;
    &lt;streamable&gt;1&lt;/streamable&gt;
    &lt;image size=&quot;small&quot;&gt;...&lt;/image&gt;
    &lt;image size=&quot;medium&quot;&gt;...&lt;/image&gt;
    &lt;image size=&quot;large&quot;&gt;...&lt;/image&gt;
  &lt;/artist&gt;
  &lt;artist&gt;
    &lt;name&gt;Senior Soul&lt;/name&gt;
    &lt;mbid&gt;a25cebd7-679f-40c5-b451-7f40c1f25c5b&lt;/mbid&gt;
    &lt;url&gt;http://www.last.fm/music/Senior+Soul&lt;/url&gt;
    &lt;streamable&gt;0&lt;/streamable&gt;
    &lt;image size=&quot;small&quot;&gt;...&lt;/image&gt;
    &lt;image size=&quot;medium&quot;&gt;...&lt;/image&gt;
    &lt;image size=&quot;large&quot;&gt;...&lt;/image&gt;
  &lt;/artist&gt;
  &lt;artist&gt;
  ...
  &lt;/artist&gt;
&lt;/recommendations&gt;</pre>
                                    </div>
                                
                                    <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>user.getRecommendedEvents</h1>
    <div class="wsdescription">
        Get a paginated list of all events recommended to a user by Last.fm, based
on their listening profile.
    </div>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">limit</span> (Optional) : The number of results to fetch per page. Defaults to 20.<br />
                <span class="param">page</span> (Optional) : The page number to scan to.<br />
                <span class="param">latitude</span> (Optional) : Optionally find events at a particular location (must be paired with a valid longitude)<br />
                <span class="param">longitude</span> (Optional) : Optionally find events at a particular location (must be paired with a valid latitude)<br />
                <span class="param">festivalsonly[0|1]</span> (Optional) : Whether only festivals should be returned, or all events.<br />
                <span class="param">country</span> (Optional) : Optionally find events in a particular country (use EITHER lat/long or country)<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                  <span class="param">api_sig</span> (Required) : A Last.fm method signature. See <a href="/api/authentication">authentication</a> for more information.<br />
                     <span class="param">sk</span> (Required) : A session key generated by authenticating a user via the authentication protocol.
                              <h2>Auth</h2>
                                     
                           This service requires authentication. Please see our <a href="/api/authentication">authentication</a> how-to.<br/>
                        l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;events user=&quot;RJ&quot; page=&quot;1&quot; perPage=&quot;20&quot; totalPages=&quot;5&quot; total=&quot;100&quot;&gt;
  &lt;event&gt;
    &lt;id&gt;792218&lt;/id&gt;
    &lt;title&gt;Night Slugs presents: TROUBLE &amp; BASS&lt;/title&gt;
    &lt;artists&gt;
      &lt;artist&gt;Drop the Lime&lt;/artist&gt;
      &lt;artist&gt;Math Head&lt;/artist&gt;
      &lt;artist&gt;L-VIS 1990&lt;/artist&gt;
      &lt;artist&gt;The Captain&lt;/artist&gt;
      &lt;artist&gt;Bok Bok&lt;/artist&gt;
      &lt;artist&gt;Star Eyes&lt;/artist&gt;
      &lt;headliner&gt;Drop the Lime&lt;/headliner&gt;
    &lt;/artists&gt;
    &lt;venue&gt;
      &lt;name&gt;East Village&lt;/name&gt;
      &lt;location&gt;
        &lt;city&gt;London&lt;/city&gt;
        &lt;country&gt;United Kingdom&lt;/country&gt;
        &lt;street&gt;89 Great Eastern Street&lt;/street&gt;
        &lt;postalcode&gt;EC2A 3HX&lt;/postalcode&gt;
        &lt;geo:point&gt;
          &lt;geo:lat&gt;51.4916446565303&lt;/geo:lat&gt;
          &lt;geo:long&gt;-0.17852783203125&lt;/geo:long&gt;
        &lt;/geo:point&gt;
      &lt;/location&gt;
      &lt;url&gt;http://www.last.fm/venue/8910355&lt;/url&gt;
    &lt;/venue&gt;
    &lt;startDate&gt;Thu, 23 Oct 2008 21:00:00&lt;/startDate&gt;
    &lt;description&gt;...&lt;/description&gt;
    &lt;image size=&quot;small&quot;&gt;...&lt;/image&gt;
    &lt;image size=&quot;medium&quot;&gt;...&lt;/image&gt;
    &lt;image size=&quot;large&quot;&gt;...&lt;/image&gt;
    &lt;attendance&gt;8&lt;/attendance&gt;
    &lt;reviews&gt;0&lt;/reviews&gt;
    &lt;tag&gt;lastfm:event=792218&lt;/tag&gt;
    &lt;url&gt;http://www.last.fm/event/792218&lt;/url&gt;
    &lt;website&gt;http://...&lt;/website&gt;
    &lt;tickets&gt;
        &lt;ticket supplier=&quot;...&quot;&gt;http://...&lt;/ticket&gt;
        ...
    &lt;/tickets&gt;
  &lt;/event&gt;
  ...
&lt;/events&gt;</pre>
                                    </div>
                                
                                    <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>user.getShouts</h1>
    <div class="wsdescription">
        Get shouts for this user. Also available as an rss feed.
    </div>
        <p class="sampleurl">
    e.g. <a href="http://ws.audioscrobbler.com/2.0/?method=user.getshouts&user=rj&api_key=b25b959554ed76058ac220b7b2e0a026">http://ws.audioscrobbler.com/2.0/?method=user.getshouts&user=rj&api_key=b25b959554ed76058ac220b...</a> 
    </p>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">user</span> (Required) : The username to fetch shouts for<br />
                <span class="param">page</span> (Optional) : The page number to fetch.  Defaults to first page.<br />
                <span class="param">limit</span> (Optional) : The number of results to fetch per page. Defaults to 50.<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                     <h2>Auth</h2>
                                     
                           This service does <b>not</b> require authentication.
                        l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;shouts user=&quot;rj&quot; total=&quot;495&quot;&gt;
  &lt;shout&gt;
    &lt;body&gt;Blah&lt;/body&gt;
    &lt;author&gt;joanofarctan&lt;/author&gt;
    &lt;date&gt;Fri, 12 Dec 2008 13:20:41&lt;/date&gt;
  &lt;/shout&gt;
  ...
&lt;/shouts&gt;</pre>
                                    </div>
                                
                    <h2>Other Formats</h2>
                            Also available as a feed in <b>rss</b> format                <p>
                                    e.g. <a href="http://ws.audioscrobbler.com/2.0/user/rj/shouts.rss">http://ws.audioscrobbler.com/2.0/user/rj/shouts.rss</a><br />
                                </p>
                                                <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>user.getTopAlbums</h1>
    <div class="wsdescription">
        Get the top albums listened to by a user. You can stipulate a time period.
Sends the overall chart by default.
    </div>
        <p class="sampleurl">
    e.g. <a href="http://ws.audioscrobbler.com/2.0/?method=user.gettopalbums&user=rj&api_key=b25b959554ed76058ac220b7b2e0a026">http://ws.audioscrobbler.com/2.0/?method=user.gettopalbums&user=rj&api_key=b25b959554ed76058ac2...</a> 
    </p>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">user</span> (Required) : The user name to fetch top albums for.<br />
                <span class="param">period</span> (Optional) : overall | 7day | 1month | 3month | 6month | 12month - The time period over which to retrieve top albums for.<br />
                <span class="param">limit</span> (Optional) : The number of results to fetch per page. Defaults to 50.<br />
                <span class="param">page</span> (Optional) : The page number to fetch.  Defaults to first page.<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                     <h2>Auth</h2>
                                     
                           This service does <b>not</b> require authentication.
                        l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;topalbums user=&quot;RJ&quot; type=&quot;overall&quot;&gt;
  &lt;album rank=&quot;1&quot;&gt;
    &lt;name&gt;Images and Words&lt;/name&gt;
    &lt;playcount&gt;174&lt;/playcount&gt;
    &lt;mbid&gt;f20971f2-c8ad-4d26-91ab-730f6dedafb2&lt;/mbid&gt;  
    &lt;url&gt;
      http://www.last.fm/music/Dream+Theater/Images+and+Words
    &lt;/url&gt;
    &lt;artist&gt;
      &lt;name&gt;Dream Theater&lt;/name&gt;
      &lt;mbid&gt;28503ab7-8bf2-4666-a7bd-2644bfc7cb1d&lt;/mbid&gt;
      &lt;url&gt;http://www.last.fm/music/Dream+Theater&lt;/url&gt;
    &lt;/artist&gt;
    &lt;image size=&quot;small&quot;&gt;...&lt;/image&gt;
    &lt;image size=&quot;medium&quot;&gt;...&lt;/image&gt;
    &lt;image size=&quot;large&quot;&gt;...&lt;/image&gt;
  &lt;/album&gt;
&lt;/topalbums&gt;</pre>
                                    </div>
                                
                                    <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>user.getTopArtists</h1>
    <div class="wsdescription">
        Get the top artists listened to by a user. You can stipulate a time period.
Sends the overall chart by default.
    </div>
        <p class="sampleurl">
    e.g. <a href="http://ws.audioscrobbler.com/2.0/?method=user.gettopartists&user=rj&api_key=b25b959554ed76058ac220b7b2e0a026">http://ws.audioscrobbler.com/2.0/?method=user.gettopartists&user=rj&api_key=b25b959554ed76058ac...</a> 
    </p>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">user</span> (Required) : The user name to fetch top artists for.<br />
                <span class="param">period</span> (Optional) : overall | 7day | 1month | 3month | 6month | 12month - The time period over which to retrieve top artists for.<br />
                <span class="param">limit</span> (Optional) : The number of results to fetch per page. Defaults to 50.<br />
                <span class="param">page</span> (Optional) : The page number to fetch.  Defaults to first page.<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                     <h2>Auth</h2>
                                     
                           This service does <b>not</b> require authentication.
                        l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;topartists user=&quot;RJ&quot; type=&quot;overall&quot;&gt;
  &lt;artist rank=&quot;1&quot;&gt;
    &lt;name&gt;Dream Theater&lt;/name&gt;
    &lt;playcount&gt;1337&lt;/playcount&gt;
    &lt;mbid&gt;28503ab7-8bf2-4666-a7bd-2644bfc7cb1d&lt;/mbid&gt;
    &lt;url&gt;http://www.last.fm/music/Dream+Theater&lt;/url&gt;
    &lt;streamable&gt;1&lt;/streamable&gt;
    &lt;image size=&quot;small&quot;&gt;...&lt;/image&gt;
    &lt;image size=&quot;medium&quot;&gt;...&lt;/image&gt;
    &lt;image size=&quot;large&quot;&gt;...&lt;/image&gt;
  &lt;/artist&gt;
  ...
&lt;/topartists&gt;</pre>
                                    </div>
                                
                                    <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>user.getTopTags</h1>
    <div class="wsdescription">
        Get the top tags used by this user.
    </div>
        <p class="sampleurl">
    e.g. <a href="http://ws.audioscrobbler.com/2.0/?method=user.gettoptags&user=rj&api_key=b25b959554ed76058ac220b7b2e0a026">http://ws.audioscrobbler.com/2.0/?method=user.gettoptags&user=rj&api_key=b25b959554ed76058ac220...</a> 
    </p>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">user</span> (Required) : The user name<br />
                <span class="param">limit</span> (Optional) : Limit the number of tags returned<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                     <h2>Auth</h2>
                                     
                           This service does <b>not</b> require authentication.
                        l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;toptags user=&quot;RJ&quot;&gt;
  &lt;tag&gt;
    &lt;name&gt;rock&lt;/name&gt;
    &lt;count&gt;12&lt;/count&gt;
    &lt;url&gt;www.last.fm/tag/rock&lt;/url&gt;
  &lt;/tag&gt;
  ...
&lt;/toptags&gt;</pre>
                                    </div>
                                
                    <h2>Other Formats</h2>
                            Also available as a feed in <b>txt</b> format                <p>
                                    e.g. <a href="http://ws.audioscrobbler.com/2.0/user/rj/toptags.txt">http://ws.audioscrobbler.com/2.0/user/rj/toptags.txt</a><br />
                                </p>
                                                <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>user.getTopTracks</h1>
    <div class="wsdescription">
        Get the top tracks listened to by a user. You can stipulate a time period.
Sends the overall chart by default.
    </div>
        <p class="sampleurl">
    e.g. <a href="http://ws.audioscrobbler.com/2.0/?method=user.gettoptracks&user=rj&api_key=b25b959554ed76058ac220b7b2e0a026">http://ws.audioscrobbler.com/2.0/?method=user.gettoptracks&user=rj&api_key=b25b959554ed76058ac2...</a> 
    </p>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">user</span> (Required) : The user name to fetch top tracks for.<br />
                <span class="param">period</span> (Optional) : overall | 7day | 1month | 3month | 6month | 12month - The time period over which to retrieve top tracks for.<br />
                <span class="param">limit</span> (Optional) : The number of results to fetch per page. Defaults to 50.<br />
                <span class="param">page</span> (Optional) : The page number to fetch.  Defaults to first page.<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                     <h2>Auth</h2>
                                     
                           This service does <b>not</b> require authentication.
                        l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;toptracks user=&quot;RJ&quot; type=&quot;overall&quot;&gt;  
  &lt;track rank=&quot;1&quot;&gt;
    &lt;name&gt;Learning to Live&lt;/name&gt;
    &lt;playcount&gt;42&lt;/playcount&gt;
    &lt;mbid/&gt;
    &lt;url&gt;
      http://www.last.fm/music/Dream+Theater/_/Learning+to+Live
    &lt;/url&gt;
    &lt;streamable fulltrack=&quot;0&quot;&gt;1&lt;/streamable&gt;
    &lt;artist&gt;
      &lt;name&gt;Dream Theater&lt;/name&gt;
      &lt;mbid&gt;28503ab7-8bf2-4666-a7bd-2644bfc7cb1d&lt;/mbid&gt;
      &lt;url&gt;http://www.last.fm/music/Dream+Theater&lt;/url&gt;
    &lt;/artist&gt;
    &lt;image size=&quot;small&quot;&gt;...&lt;/image&gt;
    &lt;image size=&quot;medium&quot;&gt;...&lt;/image&gt;
    &lt;image size=&quot;large&quot;&gt;...&lt;/image&gt;
  &lt;/track&gt;
  ...
&lt;/toptracks&gt;</pre>
                                    </div>
                                
                                    <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>user.getWeeklyAlbumChart</h1>
    <div class="wsdescription">
        Get an album chart for a user profile, for a given date range. If no date
range is supplied, it will return the most recent album chart for this
user.
    </div>
        <p class="sampleurl">
    e.g. <a href="http://ws.audioscrobbler.com/2.0/?method=user.getweeklyalbumchart&user=rj&api_key=b25b959554ed76058ac220b7b2e0a026">http://ws.audioscrobbler.com/2.0/?method=user.getweeklyalbumchart&user=rj&api_key=b25b959554ed7...</a> 
    </p>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">user</span> (Required) : The last.fm username to fetch the charts of.<br />
                <span class="param">from</span> (Optional) : The date at which the chart should start from. See User.getChartsList for more.<br />
                <span class="param">to</span> (Optional) : The date at which the chart should end on. See User.getChartsList for more.<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                     <h2>Auth</h2>
                                     
                           This service does <b>not</b> require authentication.
                        l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;weeklyalbumchart user=&quot;RJ&quot; from=&quot;1212321600&quot; to=&quot;1212926400&quot;&gt;
  &lt;album rank=&quot;1&quot;&gt;
    &lt;artist mbid=&quot;80e577ba-841f-43ba-9f32-72e7c1692336&quot;&gt;David Hudson&lt;/artist&gt;
    &lt;name&gt;Bedarra&lt;/name&gt;
    &lt;mbid&gt;dc30face-71db-413a-bcae-06accbd64aae&lt;/mbid&gt;
    &lt;playcount&gt;10&lt;/playcount&gt;
    &lt;url&gt;http://www.last.fm/music/David+Hudson+and+Friends/Bedarra&lt;/url&gt;
  &lt;/album&gt;
  ...
&lt;/weeklyalbumchart&gt;</pre>
                                    </div>
                                
                                    <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>user.getWeeklyArtistChart</h1>
    <div class="wsdescription">
        Get an artist chart for a user profile, for a given date range. If no date
range is supplied, it will return the most recent artist chart for this
user.
    </div>
        <p class="sampleurl">
    e.g. <a href="http://ws.audioscrobbler.com/2.0/?method=user.getweeklyartistchart&user=rj&api_key=b25b959554ed76058ac220b7b2e0a026">http://ws.audioscrobbler.com/2.0/?method=user.getweeklyartistchart&user=rj&api_key=b25b959554ed...</a> 
    </p>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">user</span> (Required) : The last.fm username to fetch the charts of.<br />
                <span class="param">from</span> (Optional) : The date at which the chart should start from. See User.getWeeklyChartList for more.<br />
                <span class="param">to</span> (Optional) : The date at which the chart should end on. See User.getWeeklyChartList for more.<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                     <h2>Auth</h2>
                                     
                           This service does <b>not</b> require authentication.
                        l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;weeklyartistchart user=&quot;RJ&quot; from=&quot;1212321600&quot; to=&quot;1212926400&quot;&gt;
  &lt;artist rank=&quot;1&quot;&gt;
    &lt;name&gt;David Hudson and Friends&lt;/name&gt;
    &lt;mbid&gt;80e577ba-841f-43ba-9f32-72e7c1692336&lt;/mbid&gt;
    &lt;playcount&gt;18&lt;/playcount&gt;
    &lt;url&gt;http://www.last.fm/music/David+Hudson+and+Friends&lt;/url&gt;
  &lt;/artist&gt;
  ...
&lt;/weeklyartistchart&gt;</pre>
                                    </div>
                                
                                    <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>user.getWeeklyChartList</h1>
    <div class="wsdescription">
        Get a list of available charts for this user, expressed as date ranges
which can be sent to the chart services.
    </div>
        <p class="sampleurl">
    e.g. <a href="http://ws.audioscrobbler.com/2.0/?method=user.getweeklychartlist&user=rj&api_key=b25b959554ed76058ac220b7b2e0a026">http://ws.audioscrobbler.com/2.0/?method=user.getweeklychartlist&user=rj&api_key=b25b959554ed76...</a> 
    </p>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">user</span> (Required) : The last.fm username to fetch the charts list for.<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                     <h2>Auth</h2>
                                     
                           This service does <b>not</b> require authentication.
                        l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;weeklychartlist user=&quot;RJ&quot;&gt;
  &lt;chart from=&quot;1108296002&quot; to=&quot;1108900802&quot;/&gt;
  &lt;chart from=&quot;1108900801&quot; to=&quot;1109505601&quot;/&gt;
  ...
&lt;/weeklychartlist&gt;</pre>
                                    </div>
                                
                                    <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>user.getWeeklyTrackChart</h1>
    <div class="wsdescription">
        Get a track chart for a user profile, for a given date range. If no date
range is supplied, it will return the most recent track chart for this
user.
    </div>
        <p class="sampleurl">
    e.g. <a href="http://ws.audioscrobbler.com/2.0/?method=user.getweeklytrackchart&user=rj&api_key=b25b959554ed76058ac220b7b2e0a026">http://ws.audioscrobbler.com/2.0/?method=user.getweeklytrackchart&user=rj&api_key=b25b959554ed7...</a> 
    </p>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">user</span> (Required) : The last.fm username to fetch the charts of.<br />
                <span class="param">from</span> (Optional) : The date at which the chart should start from. See User.getWeeklyChartList for more.<br />
                <span class="param">to</span> (Optional) : The date at which the chart should end on. See User.getWeeklyChartList for more.<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                     <h2>Auth</h2>
                                     
                           This service does <b>not</b> require authentication.
                        l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;weeklytrackchart user=&quot;joanofarctan&quot; from=&quot;1212321600&quot; to=&quot;1212926400&quot;&gt;
  &lt;track rank=&quot;1&quot;&gt;
    &lt;artist mbid=&quot;17b0d7f1-fad3-404e-87ae-874e6e158c3a&quot;&gt;Dirk Leyers&lt;/artist&gt;
    &lt;name&gt;Wellen&lt;/name&gt;
    &lt;mbid/&gt;
    &lt;playcount&gt;3&lt;/playcount&gt;
    &lt;url&gt;http://www.last.fm/music/Dirk+Leyers/_/Wellen&lt;/url&gt;
  &lt;/track&gt;
  ...
&lt;/weeklytrackchart&gt;</pre>
                                    </div>
                                
                                    <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>user.shout</h1>
    <div class="wsdescription">
        Shout on this user's shoutbox
    </div>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">user</span> (Required) : The name of the user to shout on.<br />
                <span class="param">message</span> (Required) : The message to post to the shoutbox.<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                  <span class="param">api_sig</span> (Required) : A Last.fm method signature. See <a href="/api/authentication">authentication</a> for more information.<br />
                     <span class="param">sk</span> (Required) : A session key generated by authenticating a user via the authentication protocol.
                              <h2>Auth</h2>
                                     
                           This service requires authentication. Please see our <a href="/api/authentication">authentication</a> how-to.<br/>
                                        This is a <b>write</b> service and must be accessed with an HTTP POST request. All parameters should be sent in the POST body, including the 'method' parameter. See <a href="/api/rest">rest requests</a> for more information.
            l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;lfm status=&quot;ok&quot; /&gt;</pre>
                                    </div>
                                
                                    <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>venue.getEvents</h1>
    <div class="wsdescription">
        Get a list of upcoming events at this venue.
    </div>
        <p class="sampleurl">
    e.g. <a href="http://ws.audioscrobbler.com/2.0/?method=venue.getevents&api_key=b25b959554ed76058ac220b7b2e0a026&venue=8908030">http://ws.audioscrobbler.com/2.0/?method=venue.getevents&api_key=b25b959554ed76058ac220b7b2e0a0...</a> 
    </p>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">venue</span> (Required) :The id for the venue you would like to fetch event listings for.<br />
                <span class="param">festivalsonly[0|1]</span> (Optional) : Whether only festivals should be returned, or all events.<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                     <h2>Auth</h2>
                                     
                           This service does <b>not</b> require authentication.
                        l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;events venue=&quot;Cafe OTO&quot;&gt;
  &lt;event&gt;
    &lt;id&gt;835264&lt;/id&gt;
    &lt;title&gt;Calling Signals 08&lt;/title&gt;
    &lt;artists&gt;
      &lt;artist&gt;Frode Gjerstad&lt;/artist&gt;
      &lt;artist&gt;Lol Coxhill&lt;/artist&gt;
      &lt;artist&gt;Paal Nilssen-Love&lt;/artist&gt;
      &lt;artist&gt;Nick Stephens&lt;/artist&gt;
      &lt;headliner&gt;Frode Gjerstad&lt;/headliner&gt;
    &lt;/artists&gt;
    &lt;venue&gt;
      &lt;id&gt;8908030&lt;/id&gt;
      &lt;name&gt;Cafe OTO&lt;/name&gt;
      &lt;location&gt;
        &lt;city&gt;London&lt;/city&gt;
        &lt;country&gt;United Kingdom&lt;/country&gt;
        &lt;street&gt;20 Ashwin St&lt;/street&gt;
        &lt;postalcode&gt;E8 3DL&lt;/postalcode&gt;
        &lt;geo:point&gt;
          &lt;geo:lat&gt;51.4916446565303&lt;/geo:lat&gt;
          &lt;geo:long&gt;-0.17852783203125&lt;/geo:long&gt;
        &lt;/geo:point&gt;
      &lt;/location&gt;
      &lt;url&gt;http://www.last.fm/venue/8908030&lt;/url&gt;
    &lt;/venue&gt;
    &lt;startDate&gt;Mon, 15 Dec 2008 20:00:00&lt;/startDate&gt;
    &lt;description&gt;...&lt;/description&gt;
    &lt;image size=&quot;small&quot;&gt;...&lt;/image&gt;
    &lt;image size=&quot;medium&quot;&gt;...&lt;/image&gt;
    &lt;image size=&quot;large&quot;&gt;...&lt;/image&gt;
    &lt;attendance&gt;2&lt;/attendance&gt;
    &lt;reviews&gt;0&lt;/reviews&gt;
    &lt;tag&gt;lastfm:event=835264&lt;/tag&gt;
    &lt;url&gt;http://www.last.fm/event/835264&lt;/url&gt;
    &lt;website&gt;http://...&lt;/website&gt;
    &lt;tickets&gt;
      &lt;ticket supplier=&quot;...&quot;&gt;http://...&lt;/ticket&gt;
      ...
    &lt;/tickets&gt;
  &lt;/event&gt;
  ...
&lt;/events&gt;</pre>
                                    </div>
                                
                    <h2>Other Formats</h2>
                            Also available as a feed in <b>rss,ical</b> formats                <p>
                                    e.g. <a href="http://ws.audioscrobbler.com/2.0/venue/8908030/events.rss">http://ws.audioscrobbler.com/2.0/venue/8908030/events.rss</a><br />
                                    e.g. <a href="http://ws.audioscrobbler.com/2.0/venue/8908030/events.ical">http://ws.audioscrobbler.com/2.0/venue/8908030/events.ical</a><br />
                                </p>
                                                <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>venue.getPastEvents</h1>
    <div class="wsdescription">
        Get a paginated list of all the events held at this venue in the past.
    </div>
        <p class="sampleurl">
    e.g. <a href="http://ws.audioscrobbler.com/2.0/?method=venue.getpastevents&api_key=b25b959554ed76058ac220b7b2e0a026&venue=8908030">http://ws.audioscrobbler.com/2.0/?method=venue.getpastevents&api_key=b25b959554ed76058ac220b7b2...</a> 
    </p>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">venue</span> (Required) :The id for the venue you would like to fetch event listings for.<br />
                <span class="param">festivalsonly[0|1]</span> (Optional) : Whether only festivals should be returned, or all events.<br />
                <span class="param">page</span> (Optional) :The page of results to return.<br />
                <span class="param">limit</span> (Optional) : The number of results to fetch per page. Defaults to 50.<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                     <h2>Auth</h2>
                                     
                           This service does <b>not</b> require authentication.
                        l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;events venue=&quot;Cafe OTO&quot; page=&quot;1&quot; perPage=&quot;50&quot; total=&quot;103&quot; totalPages=&quot;3&quot;&gt;
  &lt;event&gt;
    &lt;id&gt;835264&lt;/id&gt;
    &lt;title&gt;Calling Signals 08&lt;/title&gt;
    &lt;artists&gt;
      &lt;artist&gt;Frode Gjerstad&lt;/artist&gt;
      &lt;artist&gt;Lol Coxhill&lt;/artist&gt;
      &lt;artist&gt;Paal Nilssen-Love&lt;/artist&gt;
      &lt;artist&gt;Nick Stephens&lt;/artist&gt;
      &lt;headliner&gt;Frode Gjerstad&lt;/headliner&gt;
    &lt;/artists&gt;
    &lt;venue&gt;
      &lt;id&gt;8908030&lt;/id&gt;
      &lt;name&gt;Cafe OTO&lt;/name&gt;
      &lt;location&gt;
        &lt;city&gt;London&lt;/city&gt;
        &lt;country&gt;United Kingdom&lt;/country&gt;
        &lt;street&gt;20 Ashwin St&lt;/street&gt;
        &lt;postalcode&gt;E8 3DL&lt;/postalcode&gt;
        &lt;geo:point&gt;
          &lt;geo:lat&gt;51.4916446565303&lt;/geo:lat&gt;
          &lt;geo:long&gt;-0.17852783203125&lt;/geo:long&gt;
        &lt;/geo:point&gt;
      &lt;/location&gt;
      &lt;url&gt;http://www.last.fm/venue/8908030&lt;/url&gt;
    &lt;/venue&gt;
    &lt;startDate&gt;Mon, 15 Dec 2008 20:00:00&lt;/startDate&gt;
    &lt;description&gt;...&lt;/description&gt;
    &lt;image size=&quot;small&quot;&gt;...&lt;/image&gt;
    &lt;image size=&quot;medium&quot;&gt;...&lt;/image&gt;
    &lt;image size=&quot;large&quot;&gt;...&lt;/image&gt;
    &lt;attendance&gt;2&lt;/attendance&gt;
    &lt;reviews&gt;0&lt;/reviews&gt;
    &lt;tag&gt;lastfm:event=835264&lt;/tag&gt;
    &lt;url&gt;http://www.last.fm/event/835264&lt;/url&gt;
    &lt;website&gt;http://...&lt;/website&gt;
    &lt;tickets&gt;
      &lt;ticket supplier=&quot;...&quot;&gt;http://...&lt;/ticket&gt;
      ...
    &lt;/tickets&gt;
  &lt;/event&gt;
  ...
&lt;/events&gt;</pre>
                                    </div>
                                
                    <h2>Other Formats</h2>
                            Also available as a feed in <b>rss,ical</b> formats                <p>
                                    e.g. <a href="http://ws.audioscrobbler.com/2.0/venue/8908030/pastevents.rss">http://ws.audioscrobbler.com/2.0/venue/8908030/pastevents.rss</a><br />
                                    e.g. <a href="http://ws.audioscrobbler.com/2.0/venue/8908030/pastevents.ical">http://ws.audioscrobbler.com/2.0/venue/8908030/pastevents.ical</a><br />
                                </p>
                                                <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            

<h1>venue.search</h1>
    <div class="wsdescription">
        Search for a venue by venue name
    </div>
        <p class="sampleurl">
    e.g. <a href="http://ws.audioscrobbler.com/2.0/?method=venue.search&api_key=b25b959554ed76058ac220b7b2e0a026&venue=arena">http://ws.audioscrobbler.com/2.0/?method=venue.search&api_key=b25b959554ed76058ac220b7b2e0a026&...</a> 
    </p>
            <div id="wsdescriptor">
        <h2>Params</h2>
                        <span class="param">venue</span> (Required) : The venue name you would like to search for.<br />
                <span class="param">page</span> (Optional) : The results page you would like to fetch<br />
                <span class="param">limit</span> (Optional) : The number of results to fetch per page. Defaults to 50.<br />
                <span class="param">country</span> (Optional) : Filter your results by country. Expressed as an ISO 3166-2 code.<br />
                 <span class="param">api_key</span> (Required) : A Last.fm API key.<br />
                     <h2>Auth</h2>
                                     
                           This service does <b>not</b> require authentication.
                        l
            <h2>Sample Response</h2>
                                                                                                                                                <div id="sample">
                    <pre>&lt;results for=&quot;arena&quot;&gt;
  &lt;opensearch:Query role=&quot;request&quot; searchTerms=&quot;arena&quot; startPage=&quot;1&quot;/&gt;
  &lt;opensearch:totalResults&gt;92&lt;/opensearch:totalResults&gt;
  &lt;opensearch:startIndex&gt;0&lt;/opensearch:startIndex&gt;
  &lt;opensearch:itemsPerPage&gt;50&lt;/opensearch:itemsPerPage&gt;
  &lt;venuematches&gt;
    &lt;venue&gt;
      &lt;id&gt;8816229&lt;/id&gt;
      &lt;name&gt;Arena&lt;/name&gt;
      &lt;location&gt;
        &lt;city&gt;Exeter&lt;/city&gt;
        &lt;country&gt;United Kingdom&lt;/country&gt;
        &lt;street/&gt;
        &lt;postalcode/&gt;
        &lt;geo:point&gt;
          &lt;geo:lat&gt;50.7&lt;/geo:lat&gt;
          &lt;geo:long&gt;-3.5333333&lt;/geo:long&gt;
        &lt;/geo:point&gt;
      &lt;/location&gt;
      &lt;url&gt;http://www.last.fm/venue/8816229&lt;/url&gt;
    &lt;/venue&gt;
    ...
  &lt;/venuematches&gt;
&lt;/results&gt;</pre>
                                    </div>
                                
                                    <h2>Errors</h2>
            <ul>
                                                            <li><span class="param">2</span> : Invalid service - This service does not exist</li>
                        <li><span class="param">3</span> : Invalid Method - No method with that name in this package</li>
                        <li><span class="param">4</span> : Authentication Failed - You do not have permissions to access the service</li>
                        <li><span class="param">5</span> : Invalid format - This service doesn't exist in that format</li>
                        <li><span class="param">6</span> : Invalid parameters - Your request is missing a required parameter</li>
                        <li><span class="param">7</span> : Invalid resource specified</li>
                        <li><span class="param">8</span> : Operation failed - Something else went wrong</li>
                        <li><span class="param">9</span> : Invalid session key - Please re-authenticate</li>
                        <li><span class="param">10</span> : Invalid API key - You must be granted a valid key by last.fm</li>
                        <li><span class="param">11</span> : Service Offline - This service is temporarily offline. Try again later.</li>
                        <li><span class="param">13</span> : Invalid method signature supplied</li>
                        <li><span class="param">16</span> : There was a temporary error processing your request. Please try again</li>
                        <li><span class="param">26</span> : Suspended API key - Access for your account has been suspended, please contact Last.fm</li>
                        <li><span class="param">29</span> : Rate limit exceeded - Your IP has made too many requests in a short period</li>
                        </ul>
            
</body>
</html>